Método IKeyStore::GetKeyValue (dbgmodel.h)
O método GetKeyValue é o primeiro método para o qual um cliente irá para localizar o valor de uma chave específica no repositório de metadados. Se a chave especificada pelo argumento key existir no repositório (ou no repositório pai), o valor dessa chave e os metadados associados a ela serão retornados. Se o valor da chave for um acessador de propriedade (um IModelPropertyAccessor boxed em um IModelObject), o método GetValue do acessador de propriedade será automaticamente chamado por GetKeyValue e o valor subjacente da propriedade retornada.
Sintaxe
HRESULT GetKeyValue(
PCWSTR key,
_COM_Errorptr_opt_ IModelObject **object,
IKeyStore **metadata
);
Parâmetros
key
O nome da chave para a qual retornar um valor.
object
O valor da chave será retornado aqui. Se o valor da chave for um acessador de propriedade, o método GetValue será chamado no acessador de propriedade e esse valor subjacente será retornado aqui..
metadata
Todos os metadados associados à chave são retornados opcionalmente aqui. Não há nenhum uso presente para metadados de segundo nível. Esse argumento deve, portanto, normalmente ser especificado como nulo.
Retornar valor
Esse método retorna HRESULT que indica êxito ou falha.
Comentários
Exemplo de código
ComPtr<IKeyStore> spMetadata; /* get a metadata store */
ComPtr<IModelObject> spRadix;
if (SUCCEEDED(spMetadata->GetKeyValue(L"PreferredRadix", &spRadix, nullptr)))
{
// spRadix has the preferred display radix. Use GetIntrinsicValueAs to unbox.
}
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | dbgmodel.h |