Función GetPropertyHandle
Devuelve un controlador único que identifica una propiedad.
Nota
Esta API es solo para uso interno. No está pensada para usarla desde código del desarrollador.
Sintaxis
HRESULT GetPropertyHandle (
[in] int vFunc,
[in] IWbemObjectAccess* ptr,
[in] LPCWSTR wszPropertyName,
[out] CIMTYPE* pType,
[out] long* pHandle
);
Parámetros
vFunc
[in] Este parámetro no se usa.
ptr
[in] Puntero a una instancia de IWbemObjectAccess.
wszPropertyName
[in] Cadena terminada en NULL de caracteres codificados en UTF16 que contiene el nombre de la propiedad.
pType
[out] Puntero a un miembro de enumeración CIMTYPE que representa el tipo CIM de la propiedad.
pHandle
[out] Puntero a un entero que contiene el manipulador de propiedad.
Valor devuelto
Los siguientes valores que devuelve esta función se definen en el archivo de encabezado WbemCli.h, aunque también puede definirlos como constantes en el código. Puede consultarlos a continuación:
| Constante | Value | Descripción |
|---|---|---|
WBEM_E_NOT_FOUND |
0x80041002 | No se encontró el nombre de propiedad especificado. |
WBEM_E_INVALID_PARAMETER |
0x80041008 | Un parámetro no es válido. |
WBEM_E_NOT_SUPPORTED |
0x8004100c | La propiedad solicitada es de tipo CIM_OBJECT o CIM_ARRAY. |
WBEM_S_NO_ERROR |
0 | Si se devuelve este valor, significará que la llamada a la función se realizó correctamente. |
Comentarios
Esta función encapsula una llamada al método IWbemClassObject::GetPropertyHandle.
Puede usar este manipulador para identificar las propiedades al usar métodos IWbemObjectAccess para leer o escribir valores de propiedad.
Los manipuladores se pueden recuperar para las propiedades de todos los tipos de datos distintos de CIM_OBJECT y CIM_ARRAY. Los manipuladores devueltos funcionan en todas las instancias de una clase.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: WMINet_Utils.idl
Versiones de .NET Framework: está disponible desde la versión 4.7.2
