DDRAddString

Funkce DDRAddString v Configuration Manager přidá řetězcovou vlastnost do záznamu zjišťování dat (DDR).

Syntaxe

[IDL]  
HRESULT DDRAddString();  

Parametry

Name
Název vlastnosti třídy.

sValue
Hodnota přiřazená vlastnosti Řetězcové hodnoty můžete zadat pouze z jednobajtů znakové sady.

nSQLWidth
Maximální délka řetězce, který lze přiřadit této vlastnosti. Tato hodnota neobsahuje znak NULL. Pro SMS 2003 nesmí být tato hodnota větší než 900 znaků. Pro SMS 2.0 nesmí být tato hodnota větší než 255 znaků.

Flags
Charakteristiky vlastnosti, například klíčové pole pro porovnání. Zadejte jeden nebo více následujících příznaků nebo nulu.

Vlajky	Popis
ADDPROP_GUID (šestnáctkové 2)	Identifikuje vlastnost, která je konstantní a jedinečně identifikuje zjištěnou položku. Pokud je pro systémové identifikátory DDR zadané, mělo by se jednat o SMSID vygenerované klientem Configuration Manager. Tento příznak se používá pouze u SMSUniqueIdentifier vlastnosti . Pokud používáte ADDPROP_GUID, musíte použít také ADDPROP_KEY. SMSUniqueIdentifier spojuje data zjišťování s daty inventáře. Pokud neshromažďujete informace o inventáři pro tento prostředek, nemusíte vlastnost zadávat SMSUniqueIdentifierv ddr.
ADDPROP_KEY (šestnáctková 8)	Identifikuje tuto vlastnost jako pole klíče při porovnání tohoto DDR s instancemi třídy v databázi. Pokud instance v databázi odpovídá datům vlastností klíče DDR, instance se aktualizuje; v opačném případě se vytvoří nová instance.
ADDPROP_NAME (šestnáctková 44)	Informuje Správce zjišťování dat (DDM), aby jako hodnotu Namevlastnosti použil řetězcovou hodnotu této vlastnosti. Vlastnost Name je jednou ze šesti dalších vlastností, které pro vás vygeneruje DDM.
ADDPROP_NAME2 (šestnáctkový 84)	Comment Přidá vlastnost do ddr a použije řetězcovou hodnotu vaší vlastnosti pro její hodnotu.

Návratové hodnoty

Pokud je funkce úspěšná, návratová hodnota se S_OK.

Pokud funkce DDRNew nebyla volána, návratová hodnota se S_FALSE.

Poznámky

Ddr musí obsahovat jednu řetězcovou vlastnost, která určuje příznak ADDPROP_NAME. Hodnota musí jednoznačně identifikovat prostředek, protože Name vlastnost se obvykle používá k dotazování dat prostředku.

Ddr je odmítnut, pokud sValue je delší než maximální délka uvedená v nSQLWidth.

Pro názvy vlastností, které obsahují více slov, můžete použít podtržítka, zřetězení nebo mezery. Můžete například zadat sName , License_NumberLicenseNumbernebo LicenseNumber. Pokud zadáte sName jako LicenseNumber, DDM zřetězí slova, což má za následek LicenseNumber. Název sloupce, který se vytvoří v databázi, je License_Numbervšak . Při přidávání DDR, které vytvářejí nebo aktualizují instance v existující třídě prostředků, musíte použít stejnou konvenci.

Požadavky

Požadavky na modul runtime

smsrsgenctl.dll

smsrsgen.dll

Další informace najdete v tématu Configuration Manager Server Runtime Requirements.

Požadavky na vývoj

Další informace najdete v tématu Požadavky na vývoj Configuration Manager Serveru.

Viz taky

DDRAddInteger
DDRAddStringArray
DDRPropertyFlagsEnum – výčet
Automatizační třída MODELU COM SMSResGen
ISMSResGen – rozhraní