DDRAddString

Die DDRAddString Funktion im Configuration Manager fügt dem Datenerkennungsdatensatz (Data Discovery Record, DDR) eine Zeichenfolgeneigenschaft hinzu.

Syntax

[IDL]
HRESULT DDRAddString();

Parameter

Name Name der Klasseneigenschaft.

sValue Wert, der der Eigenschaft zugewiesen ist. Sie können nur Zeichenfolgenwerte aus dem Singlebyte-Zeichensatz eingeben.

nSQLWidth Maximale Länge einer Zeichenfolge, die dieser Eigenschaft zugewiesen werden kann. Dieser Wert enthält nicht das NULL-Zeichen. Für SMS 2003: Dieser Wert darf nicht größer als 900 Zeichen sein. Für SMS 2.0 darf dieser Wert nicht länger als 255 Zeichen sein.

Flags Merkmale der Eigenschaft, z. B. ein Schlüsselfeld für Vergleiche. Geben Sie eines oder mehrere der folgenden Flags oder eine Null ein.

Flag Beschreibung
ADDPROP_GUID (hexadezimal 2) Identifiziert eine Eigenschaft, die konstant ist und das ermittelte Element eindeutig identifiziert. Wenn dies für System-DDRs angegeben wird, sollte dies die SMSID sein, die vom Configuration Manager-Client generiert wird.

Dieses Flag wird nur auf dem SMSUniqueIdentifier Grundstück verwendet. Wenn Sie ADDPROP_GUID verwenden, müssen Sie auch ADDPROP_KEY verwenden.

SMSUniqueIdentifier Setzt Ermittlungsdaten in Beziehung. Wenn Sie keine Bestandsinformationen für diese Ressource sammeln, müssen Sie die SMSUniqueIdentifierEigenschaft in Ihrem DDR nicht angeben.
ADDPROP_KEY (Hexadezimal 8) Identifiziert diese Eigenschaft als Schlüsselfeld während eines Vergleichs dieses DDR mit Klasseninstanzen in der Datenbank. Wenn eine Instance in der Datenbank mit den Daten der DDR-Schlüsseleigenschaften übereinstimmt, wird die Instance aktualisiert; andernfalls wird eine neue Instance erstellt.
ADDPROP_NAME (hexadezimal 44) Weist den Datenermittlungs-Manager (DDM) an, den Zeichenfolgenwert dieser Eigenschaft für den Wert der NameEigenschaft zu verwenden.

Die Name Eigenschaft ist eine von sechs anderen Eigenschaften, die vom DDM für Sie generiert werden.
ADDPROP_NAME2 (Hexadezimal 84) Fügt Ihrem DDR eine Comment Eigenschaft hinzu und verwendet den Zeichenfolgenwert Ihrer Eigenschaft als Wert.

Rückgabewerte

Wenn die Funktion erfolgreich ausgeführt wird, lautet der Rückgabewert S_OK.

Wenn die DDRNew-Funktion nicht aufgerufen wurde, lautet der Rückgabewert S_FALSE.

Hinweise

Ihr DDR muss eine Zeichenfolgeneigenschaft enthalten, die das ADDPROP_NAME Flag angibt. Der Wert muss die Ressource eindeutig identifizieren, da die Eigenschaft normalerweise zum Abfragen von Name Ressourcendaten verwendet wird.

Der DDR wird abgelehnt, wenn sValue er länger als die in angegebene maximale Länge ist nSQLWidth.

Sie können Unterstriche, Verkettungen oder Leerzeichen für Eigenschaftsnamen verwenden, die mehrere Wörter enthalten. Sie können sName z. B. angeben, , License_NumberLicenseNumberoder LicenseNumber. Wenn Sie als LicenseNumberangebensName, verkettet der DDM die Wörter, was zu LicenseNumber. Der Spaltenname, der in der Datenbank erstellt wird, lautet License_Numberjedoch . Sie müssen dieselbe Konvention verwenden, wenn Sie DDRs hinzufügen, die Instanzen in einer vorhandenen Ressourcenklasse erstellen oder aktualisieren.

Anforderungen

Laufzeitanforderungen

smsrsgenctl.dll

smsrsgen.dll

Weitere Informationen finden Sie unter Anforderungen an die Configuration Manager Server-Laufzeit.

Entwicklungsanforderungen

Weitere Informationen finden Sie unter Entwicklungsanforderungen für Configuration Manager Server.

Siehe auch

DDRAddIntegerDDRAddStringArrayDDRPropertyFlagsEnum EnumerationSMSResGen COM-AutomatisierungsklasseISMSResGen-Schnittstelle