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 a) uma determinada chave por nome. Se a chave for um acessador de propriedade , ou seja, seu valor como um IModelObject que é um IModelPropertyAccessor, 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 desativadas nesse argumento, mesmo que o método retorne um HRESULT com falha.
metadata
O repositório de metadados associado a essa chave será retornado opcionalmente nesse argumento.
Valor de retorno
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 pôde ser encontrada.
Observações
de 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
| Requisito | Valor |
|---|---|
| cabeçalho | dbgmodel.h |