Partager via

WPRCCreateInstance

  • Article

Description

Cette fonction crée une instance d’une classe spécifiée.

Syntaxe

HRESULT WPRCCreateInstance(
    _In_ REFCLSID rclsid,
    _In_opt_ LPUNKNOWN pUnkOuter,
    _In_ DWORD dwClsContext,
    _In_ REFIID riid,
    _Outptr_ LPVOID *ppv
);

Paramètres

rclsid

(In REFCLSID) : CLSID associé aux données et au code qui seront utilisés pour créer l’objet.

pUnkOuter

(In_opt LPUNKNOWN) : facultatif. Si la valeur est NULL, l’objet n’est pas créé en tant que partie d’un agrégat. Si la valeur n’est pas NULL, pointez vers l’interface IUnknown de l’objet d’agrégation (IUnknown de contrôle).

dwClsContext

(In DWORD) : contexte dans lequel le code qui gère l’objet nouvellement créé s’exécute. Les valeurs sont extraites de la classe d’énumération CLSCTX.

REFIID riid

(In REFIID) : une référence à l’identificateur de l’interface à utiliser pour communiquer avec l’objet.

ppv

(Outptr LPVOID) : adresse de la variable pointeur qui reçoit le pointeur d’interface demandé dans riid. Une fois le retour réussi, *ppv contient le pointeur d’interface demandé.

Valeur de retour

La fonction renvoie un code HRESULT. Une exécution réussie est généralement indiquée par S_OK. L’échec est indiqué par un autre code HRESULT, ce qui indique qu’une erreur s’est produite pendant l’exécution de la fonction.

Notes

Fonctions