DDRAddString

Die DDRAddString Funktion fügt in Configuration Manager dem Datenermittlungsdatensatz (DDR) eine Zeichenfolgeneigenschaft hinzu.

Syntax

[IDL]  
HRESULT DDRAddString();  

Parameter

Name
Name der Klasseneigenschaft.

sValue
Der -Eigenschaft zugewiesener Wert. Sie können nur Zeichenfolgenwerte aus dem Einzelbytezeichensatz 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 darf dieser Wert nicht größer als 900 Zeichen sein. Für SMS 2.0 darf dieser Wert nicht größer 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 identifiziert das ermittelte Element eindeutig. Wenn für System-DDRs angegeben, sollte dies die vom Configuration Manager Client generierte SMSID sein. Dieses Flag wird nur für die SMSUniqueIdentifier -Eigenschaft verwendet. Wenn Sie ADDPROP_GUID verwenden, müssen Sie auch ADDPROP_KEY verwenden. Beachten Sie, dass SMSUniqueIdentifier Ermittlungsdaten mit Bestandsdaten verknüpft. 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 Instanz in der Datenbank mit den Daten der DDR-Schlüsseleigenschaften übereinstimmt, wird die Instanz aktualisiert. Andernfalls wird eine neue Instanz erstellt.
ADDPROP_NAME (Hexadezimal 44)	Weist den Data Discovery Manager (DDM) an, den Zeichenfolgenwert dieser Eigenschaft für den Wert der NameEigenschaft zu verwenden. Die Name -Eigenschaft ist eine von sechs zusätzlichen Eigenschaften, die von DDM für Sie generiert werden.
ADDPROP_NAME2 (Hexadezimal 84)	Fügt ihrer DDR eine Eigenschaft hinzu Comment und verwendet den Zeichenfolgenwert Ihrer Eigenschaft als Wert.

Rückgabewerte

Wenn die Funktion erfolgreich ist, wird der Rückgabewert S_OK.

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

HinwBemerkungeneise

Ihr DDR muss eine Zeichenfolgeneigenschaft enthalten, die das flag ADDPROP_NAME angibt. Der Wert muss die Ressource eindeutig identifizieren, da die -Eigenschaft in der Name Regel zum Abfragen von Ressourcendaten verwendet wird.

Der DDR-Wert wird abgelehnt, wenn sValue die in nSQLWidthangegebene maximale Länge überschreitet.

Sie können Unterstriche, Verkettungen oder Leerzeichen für Eigenschaftsnamen verwenden, die mehrere Wörter enthalten. Sie können z. B. als License_Number, LicenseNumberoder LicenseNumberangebensName. Wenn Sie als LicenseNumberangebensName, verkettet der DDM die Wörter, was zu LicenseNumberführt. 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 Configuration Manager Server Runtime.

Entwicklungsanforderungen

Weitere Informationen finden Sie unter Configuration Manager Serverentwicklungsanforderungen.

Siehe auch

DDRAddInteger
DDRAddStringArray
DDRPropertyFlagsEnum-Enumeration
SMSResGen-COM-Automatisierungsklasse
ISMSResGen-Schnittstelle