Compartir por

Función GetPropertyQualifierSet

Recupera el calificador establecido para una propiedad específica.

Nota

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

Sintaxis

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

Parámetros

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

ptr
[in] El valor de este parámetro se corresponde con un puntero que apunta a una instancia de la interfaz IWbemClassObject.

wszMethod
[in] Nombre de la propiedad. El valor de wszProperty debe apuntar a un objeto LPCWSTR válido.

ppQualSet
[out] El valor de este parámetro se corresponde con el puntero de interfaz que puede usarse para acceder a los calificadores de la propiedad. 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_FAILED 0x80041001 Si se devuelve este valor, significará que se ha producido un error general.
WBEM_E_NOT_FOUND 0x80041002 Si se devuelve este valor, significará que el método que especificó no existe.
WBEM_E_OUT_OF_MEMORY 0x80041006 Memoria insuficiente para completar la operación.
WBEM_E_INVALID_PARAMETER 0x80041008 Si se devuelve este valor, significará que uno de los parámetros tiene el valor null.
WBEM_E_SYSTEM_PROPERTY 0x80041030 Si se devuelve este valor, significará que la función está intentando obtener calificadores de una propiedad del sistema.
WBEM_S_NO_ERROR 0 Si se devuelve este valor, significará que la llamada a la función se realizó correctamente.

Comentarios

Al usar esta función, se ajusta una llamada al método IWbemClassObject::GetPropertyQualifierSet.

Las llamadas a esta función solo se admitirán si el objeto en cuestión es una definición de clase CIM. La manipulación de métodos no está disponible para punteros IWbemClassObject que apuntan a instancias CIM.

Como cada método puede tener sus propios calificadores, el puntero IWbemQualifierSet permite que el llamador los agregue, edite o elimine.

Dado que las propiedades del sistema no tienen calificadores, la función devolverá el valor WBEM_E_SYSTEM_PROPERTY si se intenta obtener un puntero IWbemQualifierSet de una de estas.

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

  • Last updated on