Compartir a través de

Función GetMethodQualifierSet

  • Artículo

Recupera el calificador establecido para un método específico.

Nota

Esta API es solo para uso interno. No está pensada para usarla desde código del desarrollador.

Sintaxis

HRESULT GetMethodQualifierSet (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszMethod,
   [out] IWbemQualifierSet  **ppQualSet
);

Parámetros

vFunc
[in] Este parámetro no se usa.

ptr
[in] Puntero a una instancia de IWbemClassObject.

wszMethod
[in] Nombre del método. wszMethod debe apuntar a un objeto LPCWSTR válido.

ppQualSet
[out] Recibe el puntero de interfaz que permite acceder a los calificadores del método. El valor de ppQualSet no puede ser null. Si se produce un error, no se devuelve un nuevo objeto y el puntero se establece de modo que apunte a null.

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 El método especificado no existe.
WBEM_E_INVALID_PARAMETER 0x80041008 Si se devuelve este valor, significará que uno de los parámetros tiene el valor null.
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 ajusta una llamada al método IWbemClassObject::GetMethodQualifierSet.

Solo se admite una llamada a esta función si el objeto actual es una definición de clase CIM. La manipulación de métodos no está disponible para punteros IWbemClassObject que apuntan a instancias CIM.

Dado que cada método puede tener sus propios calificadores, el puntero IWbemQualifierSet permite al llamador agregar, editar o eliminar estos calificadores.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: WMINet_Utils.idl

Versiones de .NET Framework: está disponible desde la versión 4.7.2

Consulte también