Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La DDRAddString fonction, dans Configuration Manager, ajoute une propriété de chaîne à l’enregistrement de découverte de données (DDR).
Syntaxe
[IDL]
HRESULT DDRAddString();
Paramètres
Name Nom de la propriété de classe.
sValue Valeur attribuée à la propriété. Vous ne pouvez entrer que des valeurs de chaîne issues du jeu de caractères codés sur un octet.
nSQLWidth Longueur maximale d’une chaîne pouvant être affectée à cette propriété. Cette valeur n’inclut pas le caractère NULL. Pour SMS 2003, cette valeur ne peut pas dépasser 900 caractères. Pour SMS 2.0, cette valeur ne peut pas dépasser 255 caractères.
Flags Les caractéristiques de la propriété, telles qu’un champ clé pour les comparaisons. Entrez un ou plusieurs des indicateurs suivants ou un zéro.
| Flag | Description |
|---|---|
| ADDPROP_GUID (hexadécimal 2) | Identifie une propriété qui est constante et identifie de manière unique l’élément découvert. Si spécifié pour les DDR système, il doit s’agir du SMSID généré par le client Configuration Manager. Cet indicateur n’est utilisé que sur la SMSUniqueIdentifier propriété. Si vous utilisez ADDPROP_GUID, vous devez également utiliser ADDPROP_KEY.SMSUniqueIdentifier Associe les données de découverte aux données d’inventaire. Si vous ne collectez pas d’informations d’inventaire pour cette ressource, vous n’avez pas besoin de spécifier la SMSUniqueIdentifierpropriété dans votre DDR. |
| ADDPROP_KEY (hexadécimal 8) | Identifie cette propriété en tant que champ clé lors d’une comparaison de cette DDR avec des instances de classe dans la base de données. Si un instance de la base de données correspond aux données des propriétés de la clé DDR, le instance est mis à jour ; sinon, un nouveau instance est créé. |
| ADDPROP_NAME (hexadécimal 44) | Indique au Gestionnaire de découverte de données (DDM) d’utiliser la valeur de chaîne de cette propriété pour la valeur de la Namepropriété.La Name propriété est l’une des six autres propriétés générées pour vous par le DDM. |
| ADDPROP_NAME2 (hexadécimal 84) | Ajoute une Comment propriété à votre DDR et utilise la valeur de chaîne de votre propriété pour sa valeur. |
Valeurs de retour
Si la fonction réussit, la valeur de retour est S_OK.
Si la fonction DDRNew n’a pas été appelée, la valeur de retour est S_FALSE.
Remarques
Votre DDR doit contenir une propriété de chaîne qui spécifie l’indicateur ADDPROP_NAME. La valeur doit identifier la ressource de manière unique, car la Name propriété est généralement utilisée pour interroger des données de ressource.
La DDR est rejetée si sValue elle est supérieure à la longueur maximale spécifiée dans nSQLWidth.
Vous pouvez utiliser des traits de soulignement, des concaténations ou des espaces pour les noms de propriété qui contiennent plusieurs mots. Par exemple, vous pouvez spécifier sName comme License_Number, LicenseNumberou LicenseNumber. Si vous spécifiez sName la valeur LicenseNumber, le DDM concatène les mots, ce qui donne LicenseNumber. Toutefois, le nom de colonne, qui est créé dans la base de données, est License_Number. Vous devez utiliser la même convention lorsque vous ajoutez des DDR qui créent ou mettent à jour des instances dans une classe de ressource existante.
Configuration requise
Configuration requise pour l’exécution
smsrsgenctl.dll
smsrsgen.dll
Pour plus d’informations, consultez Configuration requise pour Configuration Manager Server Runtime.
Configuration requise pour le développement
Pour plus d’informations, consultez Configuration requise pour le développement du serveur Configuration Manager.
Voir aussi
DDRAddIntegerDDRAddStringArrayÉnumération DDRPropertyFlagsEnumClasse d’automatisation COM SMSResGenInterface ISMSResGen