DDRAddString

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 affectée à la propriété . Vous pouvez uniquement entrer des valeurs de chaîne à partir du jeu de caractères codés sur un octet.

nSQLWidth
Longueur maximale d’une chaîne qui peut être affectée à cette propriété. Cette valeur n’inclut pas le caractère NULL. Pour SMS 2003 Cette valeur ne peut pas être supérieure à 900 caractères. Pour SMS 2.0, cette valeur ne peut pas être supérieure à 255 caractères.

Flags
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. S’il est spécifié pour les DDR système, il doit s’agir de l’ID SMS généré par le client Configuration Manager. Cet indicateur est utilisé uniquement sur la SMSUniqueIdentifier propriété . Si vous utilisez ADDPROP_GUID, vous devez également utiliser ADDPROP_KEY. Notez que SMSUniqueIdentifier lie 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 les instances de classe dans la base de données. Si une instance de la base de données correspond aux données des propriétés de clé DDR, l’instance est mise à jour ; sinon, une nouvelle instance est créée.
ADDPROP_NAME (hexadécimal 44)	Indique au Gestionnaire de découverte des 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 propriétés supplémentaires 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 les données de ressource.

La ddr est rejetée si sValue est plus longue que la longueur maximale spécifiée dans nSQLWidth.

Vous pouvez utiliser des traits de soulignement, une concaténation ou des espaces pour les noms de propriétés qui contiennent plusieurs mots. Par exemple, vous pouvez spécifier sName en tant que License_Number, LicenseNumberou LicenseNumber. Si vous spécifiez sName comme LicenseNumber, le DDM concatène les mots, ce qui entraîne LicenseNumber. Toutefois, le nom de la 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 ressources existante.

Configuration requise

Configuration requise pour l’exécution

smsrsgenctl.dll

smsrsgen.dll

Pour plus d’informations, consultez Configuration Manager Server Runtime Requirements.

Conditions requises pour le développement

Pour plus d’informations, consultez Configuration Manager Server Development Requirements.

Voir aussi

DDRAddInteger
DDRAddStringArray
DDRPropertyFlagsEnum, énumération
SMSResGen COM Automation, classe
ISMSResGen, interface