Función GetPropertyOrigin
Determina la clase en la que se declara una propiedad.
Nota
Esta API es solo para uso interno. No está pensada para usarla desde código del desarrollador.
Sintaxis
HRESULT GetPropertyOrigin (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[in] LPCWSTR wszMethodName,
[out] BSTR* pstrClassName
);
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.
wszMethodName
[in] El valor de este parámetro se corresponde con el nombre de la propiedad del objeto cuya clase propietaria se va a solicitar.
pstrClassName
[out] El valor de este parámetro se corresponde con el nombre de la clase propietaria de la 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 | Valor | 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 no se encontró la propiedad que se especificó. |
WBEM_E_INVALID_PARAMETER |
0x80041008 | Un parámetro no es válido. |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | Memoria insuficiente para completar la operación. |
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::GetPropertyOrigin.
Dado que las clases pueden heredar propiedades de una o varias clases base, los desarrolladores suelen determinar la propiedad en la que se define un método determinado.
El parámetro pstrClassName
no debe apuntar a un valor BSTR
válido antes de que se realice la llamada a la función, ya que se trata de un parámetro de salida (out
); este puntero no se desasigna después de que se devuelva la función.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: WMINet_Utils.idl
Versiones de .NET Framework: está disponible desde la versión 4.7.2