Delen via


DDRAddString

De DDRAddString functie voegt in Configuration Manager een tekenreekseigenschap toe aan de data discovery record (DDR).

Syntaxis

[IDL]
HRESULT DDRAddString();

Parameters

Name Naam van de klasse-eigenschap.

sValue Waarde die is toegewezen aan de eigenschap. U kunt alleen tekenreekswaarden invoeren uit de tekenset met één byte.

nSQLWidth Maximale lengte van een tekenreeks die kan worden toegewezen aan deze eigenschap. Deze waarde bevat niet het NULL-teken. Voor SMS 2003 Mag deze waarde 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 het gedetecteerde item uniek identificeert. Als dit is opgegeven voor systeem-DDR's, moet dit de SMSID zijn die wordt gegenereerd door de Configuration Manager-client.

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

SMSUniqueIdentifier de detectiegegevens koppelen aan inventarisgegevens. Als u geen inventarisgegevens 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 exemplaar in de database overeenkomt met de gegevens van de DDR-sleuteleigenschappen, wordt het exemplaar bijgewerkt; anders wordt er een nieuw exemplaar gemaakt.
ADDPROP_NAME (Hexadecimaal 44) Geeft de Data Discovery Manager (DDM) de tekenreekswaarde van deze eigenschap te gebruiken voor de waarde van de Nameeigenschap.

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

Retourwaarden

Als de functie slaagt, wordt de retourwaarde S_OK.

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

Opmerkingen

Uw DDR moet één tekenreekseigenschap bevatten die de vlag ADDPROP_NAME aangeeft. De waarde moet de resource uniek identificeren, omdat de Name eigenschap doorgaans wordt gebruikt om query's uit te voeren op resourcegegevens.

De DDR wordt geweigerd als sValue deze langer is dan de maximale lengte die is opgegeven in nSQLWidth.

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

Vereisten

Runtimevereisten

smsrsgenctl.dll

smsrsgen.dll

Zie runtimevereisten voor Configuration Manager server voor meer informatie.

Ontwikkelingsvereisten

Zie vereisten voor Configuration Manager serverontwikkeling voor meer informatie.

Zie ook

DDRAddIntegerDDRAddStringArrayDDRPropertyFlagsEnum OpsommingSMSResGen COM Automation-klasseISMSResGen Interface