Partager via

GetPropertyOrigin, fonction

  • Article

Détermine la classe dans laquelle une propriété est déclarée.

Notes

Cette API est destinée à un usage interne uniquement. Elle n’est pas destinée à être utilisée dans le code du développeur.

Syntaxe

HRESULT GetPropertyOrigin (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszMethodName,
   [out] BSTR*              pstrClassName
);

Paramètres

vFunc
[in] Ce paramètre est inutilisé.

ptr
[in] Pointeur vers une instance IWbemClassObject.

wszMethodName
[in] Nom de la propriété de l’objet dont la classe propriétaire est demandée.

pstrClassName
[out] Reçoit le nom de la classe propriétaire de la propriété.

Valeur retournée

Les valeurs suivantes renvoyées par cette fonction sont définies dans le fichier d’en-tête WbemCli.h, ou vous pouvez les définir comme constantes dans votre code :

Constant Valeur Description
WBEM_E_FAILED 0x80041001 Il y a eu une défaillance générale.
WBEM_E_NOT_FOUND 0x80041002 La propriété spécifiée est introuvable.
WBEM_E_INVALID_PARAMETER 0x80041008 Un paramètre n'est pas valide.
WBEM_E_OUT_OF_MEMORY 0x80041006 La mémoire n'est pas suffisante pour terminer cette opération.
WBEM_S_NO_ERROR 0 L’appel de fonction a abouti.

Notes

Cette fonction inclut dans un wrapper un appel à la méthode IWbemClassObject::GetPropertyOrigin.

Dans la mesure où une classe peut hériter des propriétés d’une ou de plusieurs classes de base, les développeurs souhaitent souvent déterminer la propriété dans laquelle une méthode donnée est définie.

Le paramètre pstrClassName ne doit pas pointer vers une valeur valide BSTR avant l’appel de la fonction, car il s’agit d’un paramètre out ; ce pointeur n’est pas désalloué une fois la fonction retournée.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : WMINet_Utils.idl

Versions de .NET Framework : disponibles depuis la version 4.7.2

Voir aussi