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 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.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 un instance dans la base de données correspond aux données des propriétés de clé DDR, le instance est mis à 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 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 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
DDRAddIntegerDDRAddStringArrayDDRPropertyFlagsEnum, énumérationSMSResGen COM Automation, classeISMSResGen, interface