Compartir a través de

Función GetPropertyQualifierSet

  • Artículo

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