Método IModelObject::GetKeyValue (dbgmodel.h)
El método GetKeyValue es el primer método al que un cliente cambiará para obtener el valor de (y los metadatos asociados a) una clave determinada por nombre. Si la clave es un descriptor de acceso de propiedad, es decir, el valor es un IModelObject que es un IModelPropertyAccessor con conversión boxing, el método GetKeyValue llamará automáticamente al método GetValue del descriptor de acceso de propiedad para recuperar el valor real.
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 obtener un valor.
object
El valor de la clave se devolverá en este argumento. En algunos casos de error, la información de error extendida se puede pasar en este argumento aunque el método devuelva un HRESULT con errores.
metadata
El almacén de metadatos asociado a esta clave se devolverá opcionalmente en este argumento.
Valor devuelto
Este método devuelve HRESULT que indica éxito o error. Los valores devueltos E_BOUNDS (o E_NOT_SET en algunos casos) indican que no se encontró la clave.
Comentarios
Ejemplo 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 |
---|---|
Header | dbgmodel.h |