OleCreateDefaultHandler, fonction (ole2.h)

Article
03/04/2024

Crée une instance du gestionnaire d’incorporation par défaut. Cette instance est initialisée afin de créer un serveur local lorsque l’objet incorporé entre dans l’état d’exécution.

Syntaxe

HRESULT OleCreateDefaultHandler(
  [in]  REFCLSID  clsid,
  [in]  LPUNKNOWN pUnkOuter,
  [in]  REFIID    riid,
  [out] LPVOID    *lplpObj
);

Paramètres

[in] clsid

CLSID identifiant le serveur OLE à charger lorsque l’objet incorporé entre dans l’état d’exécution.

[in] pUnkOuter

Pointeur vers l’interface IUnknown de contrôle si le gestionnaire doit être agrégé ; NULL si elle ne doit pas être agrégée.

[in] riid

Référence à l’identificateur de l’interface, généralement IID_IOleObject, par le biais duquel l’appelant communiquera avec le gestionnaire.

[out] lplpObj

Adresse de la variable pointeur qui reçoit le pointeur d’interface demandé dans riid. Une fois le retour réussi, *ppvObj contient le pointeur d’interface demandé sur le gestionnaire nouvellement créé.

Valeur retournée

Cette fonction retourne NOERROR en cas de réussite et prend en charge la valeur de retour standard E_OUTOFMEMORY.

Remarques

OleCreateDefaultHandler crée un instance du gestionnaire d’incorporation par défaut, initialisé de sorte qu’il crée un serveur local identifié par le paramètre clsid lorsque l’objet incorporé entre dans l’état d’exécution. Si vous écrivez un gestionnaire et que vous souhaitez utiliser les services du gestionnaire par défaut, appelez OleCreateDefaultHandler. OLE l’appelle également en interne lorsque le CLSID spécifié dans un appel de création d’objet n’est pas inscrit.

Si la classe donnée n’a pas de gestionnaire spécial, un appel à OleCreateDefaultHandler produit les mêmes résultats qu’un appel à la fonction CoCreateInstance avec le paramètre de contexte de classe affecté à la valeur CLSCTX_INPROC_HANDLER.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ole2.h
Bibliothèque	Ole32.lib
DLL	Ole32.dll

Voir aussi

CLSCTX

CoCreateInstance

Partager via