Metodo IKeyStore::GetKeyValue (dbgmodel.h)
Il metodo GetKeyValue è il primo metodo a cui verrà eseguito un client per trovare il valore di una determinata chiave all'interno dell'archivio metadati. Se la chiave specificata dall'argomento chiave esiste all'interno dell'archivio (o è l'archivio padre), il valore di tale chiave e tutti i metadati associati verranno restituiti. Se il valore della chiave è una funzione di accesso di proprietà (un oggetto IModelPropertyAccessor in un oggetto IModelObject), il metodo GetValue della funzione di accesso della proprietà verrà chiamato automaticamente da GetKeyValue e dal valore sottostante della proprietà restituita.
Sintassi
HRESULT GetKeyValue(
PCWSTR key,
_COM_Errorptr_opt_ IModelObject **object,
IKeyStore **metadata
);
Parametri
key
Nome della chiave per restituire un valore per.
object
Il valore della chiave verrà restituito qui. Se il valore della chiave è una funzione di accesso alla proprietà, il metodo GetValue verrà chiamato nella funzione di accesso della proprietà e tale valore sottostante verrà restituito qui.
metadata
Tutti i metadati associati alla chiave vengono restituiti facoltativamente qui. Non è presente alcun uso per i metadati di secondo livello. Questo argomento deve pertanto essere specificato in genere come Null.
Valore restituito
Questo metodo restituisce HRESULT che indica l'esito positivo o l'errore.
Commenti
Codice di esempio
ComPtr<IKeyStore> spMetadata; /* get a metadata store */
ComPtr<IModelObject> spRadix;
if (SUCCEEDED(spMetadata->GetKeyValue(L"PreferredRadix", &spRadix, nullptr)))
{
// spRadix has the preferred display radix. Use GetIntrinsicValueAs to unbox.
}
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | dbgmodel.h |