Compartir a través de


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

El método GetKeyValue es el primer método al que un cliente irá para encontrar el valor de una clave determinada dentro del almacén de metadatos. Si la clave especificada por el argumento key existe dentro del almacén (o es el almacén primario), se devolverá el valor de esa clave y los metadatos asociados a ella. Si el valor de la clave es un descriptor de acceso de propiedad (un IModelPropertyAccessor boxed en un IModelObject), el método GetValue del descriptor de acceso de propiedad se llamará automáticamente mediante GetKeyValue y el valor subyacente de la propiedad devuelta.

Sintaxis

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

Parámetros

key

Nombre de la clave para la que se va a devolver un valor.

object

El valor de la clave se devolverá aquí. Si el valor de la clave es un descriptor de acceso de propiedad, se llamará al método GetValue en el descriptor de acceso de propiedad y ese valor subyacente se devolverá aquí.

metadata

Los metadatos asociados a la clave se devuelven opcionalmente aquí. No hay ningún uso presente para los metadatos de segundo nivel. Por lo tanto, este argumento se debe especificar normalmente como null.

Valor devuelto

Este método devuelve HRESULT que indica éxito o error.

Comentarios

Ejemplo 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
Header dbgmodel.h

Consulte también

Interfaz IKeyStore