Método CWbemProviderGlue::GetInstancePropertiesByPath (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 GetInstancePropertiesByPath recupera la instancia identificada por una ruta de acceso de objeto determinada, con solo las propiedades especificadas rellenadas. Las propiedades que se van a rellenar se denominan en una matriz CHString .

Sintaxis

HRESULT GetInstancePropertiesByPath(
        LPCWSTR         pszInstancePath,
        CInstance       **ppInstance,
        MethodContext   *pMethodContext,
  [ref] CHStringArray & csaProperties
);

Parámetros

pszInstancePath

Ruta de acceso del objeto a la instancia que se va a devolver. Este parámetro debe apuntar a una ruta de acceso completa.

ppInstance

Puntero a un puntero a una nueva instancia de CInstance cuyas claves son las especificadas por 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 úselo de la instancia mediante CInstance::GetMethodContext. Este parámetro no debe ser NULL.

[ref] csaProperties

Matriz que contiene los nombres de las propiedades que se van a copiar en la nueva instancia.

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 de instancias parciales para solicitar solo las propiedades especificadas del objeto especificado. Esta es la manera más eficaz de recuperar una instancia específica cuando se requieren más propiedades que solo las claves. Tenga en cuenta que no todos los proveedores admiten operaciones de instancia parcial. En ese caso, se rellena toda la instancia (incluidas las claves). Para obtener más información, consulte Compatibilidad con operaciones de Partial-Instance.

En la versión actual del marco de trabajo del proveedor, pszInstancePath debe resolverse para ser una ruta de acceso de instancia en el mismo equipo.

Requisitos

Consulte también

CWbemProviderGlue

GetInstanceByPath

GetInstanceKeysByPath