DDRAddString

Funkcja DDRAddString w Configuration Manager dodaje właściwość string do rekordu odnajdywania danych (DDR).

Składni

[IDL]  
HRESULT DDRAddString();  

Parametry

Name
Nazwa właściwości klasy.

sValue
Wartość przypisana do właściwości. Wartości ciągu można wprowadzać tylko z zestawu znaków jedno bajtowych.

nSQLWidth
Maksymalna długość ciągu, który można przypisać do tej właściwości. Ta wartość nie zawiera znaku NULL. W przypadku programu SMS 2003 ta wartość nie może być większa niż 900 znaków. W przypadku programu SMS 2.0 ta wartość nie może być większa niż 255 znaków.

Flags
Cechy właściwości, takie jak pole klucza dla porównań. Wprowadź co najmniej jedną z następujących flag lub zero.

Flaga	Opis
ADDPROP_GUID (szesnastkowa 2)	Identyfikuje właściwość, która jest stała i unikatowo identyfikuje odnaleziony element. Jeśli zostanie określony dla identyfikatorów DDR systemu, powinien to być identyfikator SMSID wygenerowany przez klienta Configuration Manager. Ta flaga jest używana tylko we SMSUniqueIdentifier właściwości . Jeśli używasz ADDPROP_GUID, musisz również użyć ADDPROP_KEY. SMSUniqueIdentifier odnosi dane odnajdywania do danych spisu. Jeśli nie zbierasz informacji o spisie dla tego zasobu, nie musisz określać SMSUniqueIdentifierwłaściwości w swojej trasy DDR.
ADDPROP_KEY (szesnastkowa 8)	Identyfikuje tę właściwość jako pole klucza podczas porównywania tej trasy DDR z wystąpieniami klas w bazie danych. Jeśli wystąpienie w bazie danych jest zgodne z danymi właściwości klucza DDR, wystąpienie zostanie zaktualizowane; W przeciwnym razie zostanie utworzone nowe wystąpienie.
ADDPROP_NAME (szesnastkowa 44)	Informuje menedżera odnajdywania danych (DDM), aby używał wartości ciągu tej właściwości dla wartości Namewłaściwości. Właściwość Name jest jedną z sześciu innych właściwości, które są generowane przez DDM.
ADDPROP_NAME2 (szesnastkowa 84)	Comment Dodaje właściwość do trasy DDR i używa wartości ciągu właściwości dla jej wartości.

Wartości zwracane

Jeśli funkcja powiedzie się, zwracana wartość jest S_OK.

Jeśli funkcja DDRNew nie została wywołana, zwracana wartość jest S_FALSE.

Uwagi

Twoja usługa DDR musi zawierać jedną właściwość ciągu, która określa flagę ADDPROP_NAME. Wartość musi jednoznacznie zidentyfikować zasób, Name ponieważ właściwość jest zwykle używana do wykonywania zapytań dotyczących danych zasobów.

DDR jest odrzucany, jeśli sValue jest dłuższy niż maksymalna długość określona w nSQLWidth.

Możesz użyć podkreślenia, łączenia lub spacji dla nazw właściwości zawierających wiele wyrazów. Można na przykład określić sName wartość , License_NumberLicenseNumberlub LicenseNumber. Jeśli określisz sName wartość , LicenseNumberDDM połączy wyrazy, co spowoduje .LicenseNumber Jednak nazwa kolumny, która jest tworzona w bazie danych, to License_Number. Należy użyć tej samej konwencji podczas dodawania żądań DDR, które tworzą lub aktualizują wystąpienia w istniejącej klasie zasobów.

Wymagania

Wymagania dotyczące środowiska uruchomieniowego

smsrsgenctl.dll

smsrsgen.dll

Aby uzyskać więcej informacji, zobacz wymagania dotyczące środowiska uruchomieniowego serwera Configuration Manager.

Wymagania programistyczne

Aby uzyskać więcej informacji, zobacz Configuration Manager Wymagania dotyczące programowania serwera.

Zobacz też

DDRAddInteger
DDRAddStringArray
DDRPropertyFlagsEnum, wyliczenie
SMSResGen, klasa automatyzacji COM
Interfejs ISMSResGen