Método IModelObject::GetKeyValue (dbgmodel.h)
O método GetKeyValue é o primeiro método ao qual um cliente recorrerá para obter o valor de (e os metadados associados a) uma determinada chave por nome. Se a chave for um acessador de propriedade , ou seja, seu valor como IModelObject , que é um IModelPropertyAccessor em caixa, o método GetKeyValue chamará automaticamente o método GetValue do acessador de propriedade 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 nesse 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á retornado opcionalmente nesse argumento.
Retornar valor
Esse método retorna HRESULT que indica êxito ou falha. Os valores retornados E_BOUNDS (ou E_NOT_SET em alguns casos) indicam 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
| Requisito | Valor |
|---|---|
| Cabeçalho | dbgmodel.h |