Metodo IModelObject::GetKeyValue (dbgmodel.h)
Il metodo GetKeyValue è il primo metodo a cui un client si rivolge per ottenere il valore di (e i metadati associati a) una determinata chiave in base al nome. Se la chiave è una funzione di accesso alla proprietà, ovvero è un valore come IModelObject che è un boxed IModelPropertyAccessor, il metodo GetKeyValue chiamerà automaticamente il metodo GetValue della proprietà per recuperare il valore effettivo.
Sintassi
HRESULT GetKeyValue(
PCWSTR key,
_COM_Errorptr_opt_ IModelObject **object,
IKeyStore **metadata
);
Parametri
key
Nome della chiave per cui ottenere un valore.
object
Il valore della chiave verrà restituito in questo argomento. In alcuni casi di errore, le informazioni estese sull'errore possono essere passate in questo argomento anche se il metodo restituisce un HRESULT non riuscito.
metadata
L'archivio metadati associato a questa chiave verrà restituito facoltativamente in questo argomento.
Valore restituito
Questo metodo restituisce HRESULT che indica l'esito positivo o negativo. I valori restituiti E_BOUNDS (o E_NOT_SET in alcuni casi) indicano che la chiave non è stata trovata.
Osservazioni
esempio di codice
ComPtr<IModelObject> spProcess; /* get a process object */
ComPtr<IModelObject> spProcId;
if (SUCCEEDED(spProcess->GetKeyValue(L"Id", &spProcId, nullptr)))
{
// spProcId has a boxed process id. Use GetIntrinsicValueAs to unbox it.
}
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | dbgmodel.h |