DDRAddString

Met deze DDRAddString functie, in Configuration Manager, wordt een tekenreekseigenschap toegevoegd aan de DDR (Data Discovery Record).

Syntaxis

[IDL]
HRESULT DDRAddString();

Parameters

Name De naam van de klasse-eigenschap.

sValue De waarde die aan de eigenschap is toegewezen. U kunt alleen tekenreekswaarden uit de één-byte-tekenset invoeren.

nSQLWidth De maximumlengte van een tekenreeks die aan deze eigenschap kan worden toegewezen. Deze waarde is exclusief het NULL-teken. Voor SMS 2003 Deze waarde mag niet groter zijn dan 900 tekens. Voor SMS 2.0 mag deze waarde niet groter zijn dan 255 tekens.

Flags Kenmerken van de eigenschap, zoals een sleutelveld voor vergelijkingen. Voer een of meer van de volgende vlaggen of een nul in.

Vlag Beschrijving
ADDPROP_GUID (hexadecimaal 2) Identificeert een eigenschap die constant is en identificeert op unieke wijze het ontdekte item. Indien opgegeven voor systeem-DDR's, moet dit de SMSID zijn die door de Configuration Manager-client wordt gegenereerd.

Deze vlag wordt alleen gebruikt op de SMSUniqueIdentifier eigenschap. Als u ADDPROP_GUID gebruikt, moet u ook ADDPROP_KEY gebruiken.

SMSUniqueIdentifier relateert discovery-gegevens aan voorraadgegevens. Als u geen voorraadgegevens voor deze resource verzamelt, hoeft u de SMSUniqueIdentifiereigenschap niet op te geven in uw DDR.
ADDPROP_KEY (hexadecimaal 8) Identificeert deze eigenschap als een sleutelveld tijdens een vergelijking van deze DDR met klasse-exemplaren in de database. Als een instantie in de database overeenkomt met de gegevens van de DDR-sleuteleigenschappen, wordt de instantie bijgewerkt; Anders wordt er een nieuw exemplaar gemaakt.
ADDPROP_NAME (hexadecimaal 44) Hiermee wordt aan Data Discovery Manager (DDM) opgedragen om de tekenreekswaarde van deze eigenschap te gebruiken voor de waarde van de Nameeigenschap.

De Name eigenschap is een van de zes andere eigenschappen die door de DDM voor u worden gegenereerd.
ADDPROP_NAME2 (hexadecimaal 84) Hiermee voegt u een Comment eigenschap toe aan uw DDR en wordt de tekenreekswaarde van uw eigenschap gebruikt voor de waarde.

Retourwaarden

Als de functie slaagt, is de resultaatwaarde S_OK.

Als de functie DDRNew niet is aangeroepen, is de retourwaarde S_FALSE.

Opmerkingen

Uw DDR moet één tekenreekseigenschap bevatten die de ADDPROP_NAME vlag aangeeft. De waarde moet een unieke aanduiding zijn van de resource omdat de eigenschap doorgaans wordt gebruikt voor het Name opvragen van resourcegegevens.

De DDR wordt geweigerd als sValue deze langer is dan de maximumlengte gespecificeerd in nSQLWidth.

U kunt onderstrepingstekens, samenvoegingstekens of spaties gebruiken voor eigenschapsnamen die meerdere woorden bevatten. U kunt bijvoorbeeld opgeven sName als License_Number, LicenseNumber, of LicenseNumber. Als u opgeeft sName als LicenseNumber, worden de woorden met DDM samengevoegd, wat resulteert in LicenseNumber. De kolomnaam die in de database wordt gemaakt, is License_Numberechter . U moet dezelfde conventie gebruiken wanneer u DDR's toevoegt waarmee exemplaren in een bestaande bronklasse worden gemaakt of bijgewerkt.

Vereisten

Runtime vereisten

smsrsgenctl.dll

smsrsgen.dll

Zie de vereisten voor de runtime van de Configuration Manager-server voor meer informatie.

Ontwikkelingsvereisten

Zie Vereisten voor de ontwikkeling van Configuration Manager-servers voor meer informatie.

Zie ook

DDRAddIntegerDDRAddStringArrayDDRPropertyFlagsEnum EnumerationSMSResGen COM Automation ClassISMSResGen Interface