Método CWbemProviderGlue::GetInstanceKeysByPath (wbemglue.h)
[La clase CWbemProviderGlue forma parte del marco de proveedor de WMI que ahora se considera en estado final y no habrá más trabajo de desarrollo, mejoras ni actualizaciones disponibles para problemas no relacionados con la seguridad que afecten a estas bibliotecas. Las API de MI se deben usar para todo el nuevo desarrollo.]
El método GetInstanceKeysByPath recupera la instancia identificada por una ruta de acceso de objeto determinada, con solo las propiedades de clave rellenadas.
Sintaxis
HRESULT GetInstanceKeysByPath(
LPCWSTR pszInstancePath,
CInstance **ppInstance,
MethodContext *pMethodContext
);
Parámetros
pszInstancePath
Ruta de acceso de objeto a la instancia que se va a devolver.
ppInstance
Puntero a un puntero a una nueva instancia de CInstance cuyas claves son las especificadas en pszInstancePath. El proveedor de marcos que realiza la solicitud debe liberar este puntero.
pMethodContext
Puntero al contexto actual. Se debe proporcionar un contexto para evitar interbloqueos. Use el contexto pasado al proveedor por Provider::EnumerateInstances o Provider::ExecQuery, o bien obtengalo de la instancia mediante CInstance::GetMethodContext. Este parámetro no debe ser NULL.
Valor devuelto
Devuelve WBEM_S_NO_ERROR si la operación se realizó correctamente, WBEM_E_OUT_OF_MEMORY si se produjo un error en la operación debido a la falta de memoria o a cualquier otro código de error HRESULT .
Comentarios
Este método usa operaciones de actualización parcial de instancias para solicitar solo las propiedades clave del objeto especificado. Es la manera más eficaz de comprobar la existencia de un objeto específico. Tenga en cuenta que no todos los proveedores admiten operaciones de instancia parcial. En ese caso, se rellenará toda la instancia. Para obtener más información, vea Compatibilidad con operaciones de Partial-Instance.
En la versión actual del marco de trabajo del proveedor, pszInstancePath debe resolverse para que sea una ruta de acceso de instancia en el mismo equipo.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | wbemglue.h (incluya FwCommon.h) |
| Library | FrameDyn.lib |
| Archivo DLL | FrameDynOS.dll; FrameDyn.dll |