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 valori stringa solo 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 o uno zero.
| Bandiera | Descrizione |
|---|---|
| ADDPROP_GUID (esadecimale 2) | Identifica una proprietà costante e identifica in modo univoco l'elemento individuato. Se specificato per le DDR di sistema, questo deve essere l'SMSID generato dal client Configuration Manager. Questo flag viene utilizzato solo nella SMSUniqueIdentifier proprietà . Se si usa ADDPROP_GUID, è necessario usare anche ADDPROP_KEY.SMSUniqueIdentifier mette in relazione i dati di individuazione con i dati di inventario. Se non si raccolgono informazioni sull'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 del 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 dalla DDM. |
| ADDPROP_NAME2 (esadecimale 84) | Aggiunge una Comment proprietà al DDR e usa il valore stringa della proprietà per il relativo valore. |
Valori restituiti
Se la funzione ha esito positivo, il valore restituito viene S_OK.
Se la funzione DDRNew non è stata chiamata, il valore restituito viene S_FALSE.
Osservazioni
Il DDR deve contenere una proprietà stringa che specifica il flag di ADDPROP_NAME. Il valore deve identificare in modo univoco la risorsa perché la Name proprietà viene in genere usata per eseguire query sui dati della risorsa.
Il DDR viene rifiutato se sValue è più lungo della lunghezza massima specificata in nSQLWidth.
È possibile usare caratteri di sottolineatura, concatenazione 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, il DDM concatena le parole, che restituisce LicenseNumber. Tuttavia, il nome della colonna, creato nel database, è License_Number. È necessario usare 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 Configuration Manager Requisiti di sviluppo del server.
Vedere anche
DDRAddInteger
DDRAddStringArray
Enumerazione DDRPropertyFlagsEnum
Classe di automazione COM SMSResGen
Interfaccia ISMSResGen