Método IModelObject::GetKeyValue (dbgmodel.h)

O método GetKeyValue é o primeiro método ao qual um cliente recorrerá para obter o valor (e os metadados associados) de uma determinada chave por nome. Se a chave for um acessador de propriedade , ou seja, seu valor como um IModelObject , que é um IModelPropertyAccessor em caixa, o método GetKeyValue chamará automaticamente o método GetValue do acessador de propriedades para recuperar o valor real.

Sintaxe

HRESULT GetKeyValue(
  PCWSTR                          key,
  _COM_Errorptr_opt_ IModelObject **object,
  IKeyStore                       **metadata
);

Parâmetros

key

O nome da chave para a qual obter um valor.

object

O valor da chave será retornado neste argumento. Em alguns casos de erro, as informações de erro estendidas podem ser passadas nesse argumento, mesmo que o método retorne um HRESULT com falha.

metadata

O repositório de metadados associado a essa chave será opcionalmente retornado nesse argumento.

Valor retornado

Esse método retorna HRESULT que indica êxito ou falha. Os valores retornados E_BOUNDS (ou E_NOT_SET em alguns casos) indica que a chave não foi encontrada.

Comentários

Exemplo de código

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

Requisitos

   
Cabeçalho dbgmodel.h

Confira também

Interface IModelObject