Metodo IKeyStore::SetKeyValue (dbgmodel.h)
Il metodo SetKeyValue è analogo al metodo SetKeyValue in IModelObject. Questo metodo non è in grado di creare una nuova chiave all'interno dell'archivio metadati. Se è presente una chiave esistente come indicato dall'argomento chiave, il relativo valore verrà impostato come indicato. Se la chiave è una funzione di accesso alle proprietà, il metodo SetValue verrà chiamato sulla funzione di accesso della proprietà per impostare il valore sottostante. Si noti che i metadati sono in genere statici dopo la creazione. L'uso di questo metodo in un archivio chiavi di metadati deve essere poco frequente.
Sintassi
HRESULT SetKeyValue(
PCWSTR key,
IModelObject *object
);
Parametri
key
Nome della chiave per cui impostare un valore.
object
Valore da assegnare alla chiave. Se il valore della chiave corrente è una funzione di accesso alla proprietà, il metodo SetValue verrà chiamato sulla funzione di accesso della proprietà per impostare il valore sottostante.
Valore restituito
Questo metodo restituisce HRESULT che indica l'esito positivo o negativo.
Commenti
Codice di esempio
ComPtr<IKeyStore> spMetadata; /* get a metadata store */
ComPtr<IModelObject> spValue; /* get a value to set */
// This never creates a key. Most callers should prefer SetKey
if (SUCCEEDED(spMetadata->SetKeyValue(L"KnownExistingKey", spValue.Get()))
{
// The key's value was successfully set.
}
Requisiti
Requisito | Valore |
---|---|
Intestazione | dbgmodel.h |