DDRAddString

La DDRAddString funzione, in Configuration Manager, aggiunge una proprietà stringa al record di individuazione dati (DDR).

Sintassi

[IDL]
HRESULT DDRAddString();

Parametri

Name Nome della proprietà della classe.

sValue Valore assegnato alla proprietà. È possibile immettere solo valori stringa dal set di caratteri a byte singolo.

nSQLWidth Lunghezza massima di una stringa che può essere assegnata a questa proprietà. Questo valore non include il carattere NULL. Per SMS 2003 Questo valore non può essere maggiore di 900 caratteri. Per SMS 2.0 questo valore non può essere maggiore di 255 caratteri.

Flags Caratteristiche della proprietà, ad esempio un campo chiave per i confronti. Immettere uno o più dei flag seguenti oppure uno zero.

Contrassegno Descrizione
ADDPROP_GUID (esadecimale 2) Identifica una proprietà che è costante e identifica in modo univoco l'elemento individuato. Se specificato per i DDR di sistema, dovrebbe essere l'SMSID generato dal client di Configuration Manager.

Questo flag viene usato solo nella SMSUniqueIdentifier proprietà. Se si utilizza ADDPROP_GUID, è necessario utilizzare anche ADDPROP_KEY.

SMSUniqueIdentifier Correla i dati di individuazione con i dati di inventario. Se non si raccolgono informazioni di inventario per questa risorsa, non è necessario specificare la SMSUniqueIdentifierproprietà nel DDR.
ADDPROP_KEY (esadecimale 8) Identifica questa proprietà come campo chiave durante un confronto di questo DDR con le istanze di classe nel database. Se un'istanza nel database corrisponde ai dati delle proprietà della chiave DDR, l'istanza viene aggiornata; In caso contrario, viene creata una nuova istanza.
ADDPROP_NAME (esadecimale 44) Indica a Data Discovery Manager (DDM) di utilizzare il valore stringa di questa proprietà per il valore della Nameproprietà.

La Name proprietà è una delle altre sei proprietà generate automaticamente dal DDM.
ADDPROP_NAME2 (esadecimale 84) Aggiunge una Comment proprietà al DDR e usa il valore stringa della proprietà per il suo valore.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è S_OK.

Se la funzione DDRNew non è stata chiamata, il valore restituito è S_FALSE.

Osservazioni

Il DDR deve contenere una proprietà stringa che specifichi il flag ADDPROP_NAME. Il valore deve identificare in modo univoco la risorsa perché la Name proprietà viene in genere usata per eseguire query sui dati delle risorse.

Il DDR viene rifiutato se sValue è più lungo della lunghezza massima specificata in nSQLWidth.

È possibile usare caratteri di sottolineatura, concatenazioni o spazi per i nomi di proprietà che contengono più parole. Ad esempio, è possibile specificare sName come License_Number, LicenseNumbero LicenseNumber. Se si specifica sName come LicenseNumber, DDM concatena le parole, risultando in LicenseNumber. Tuttavia, il nome della colonna, che viene creata nel database, è License_Number. È necessario utilizzare la stessa convenzione quando si aggiungono DDR che creano o aggiornano istanze in una classe di risorse esistente.

Requisiti

Requisiti di runtime

smsrsgenctl.dll

smsrsgen.dll

Per altre informazioni, vedere Configuration Manager Requisiti di runtime del server.

Requisiti di sviluppo

Per altre informazioni, vedere Requisiti di sviluppo del server di Configuration Manager.

Vedere anche

DDRAddIntegerDDRAddStringArray,DDRPropertyFlagsEnum EnumerazioneSMSResGen COM Automation ClassInterfaccia ISMSResGen