WPRCCreateInstanceUnderInstanceName

Cette fonction crée une instance d’une classe spécifiée, avec l’option permettant de spécifier le nom de l’instance.

Syntaxe

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

Paramètres

bstrInstanceName

(In_opt BSTR) : facultatif. Nom de l'instance. Si ce paramètre a une valeur NULL, la fonction crée une instance sans nom.

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.

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

Rubriques connexes

Fonctions