Metodo IModelObject::GetKeyValue (dbgmodel.h)

  • Articolo

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 di proprietà, ovvero il valore è un IModelObject che è un IModelPropertyAccessor boxed, 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 ottenere un valore.

object

Il valore della chiave verrà restituito in questo argomento. In alcuni casi di errore, le informazioni di errore estese possono essere passate in questo argomento anche se il metodo restituisce un errore HRESULT.

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 l'errore. I valori restituiti E_BOUNDS (o E_NOT_SET in alcuni casi) indicano che la chiave non è stata trovata.

Commenti

Codice di esempio

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.
}

Requisiti

Requisito Valore
Intestazione dbgmodel.h

Vedi anche

Interfaccia IModelObject