Fonction CoGetObject (objbase.h)

Article
02/29/2024

Convertit un nom d’affichage en moniker qui identifie l’objet nommé, puis se lie à l’objet identifié par le moniker.

Syntaxe

HRESULT CoGetObject(
  [in]           LPCWSTR   pszName,
  [in, optional] BIND_OPTS *pBindOptions,
  [in]           REFIID    riid,
  [out]          void      **ppv
);

Paramètres

[in] pszName

Nom d’affichage de l’objet à créer.

[in, optional] pBindOptions

Options de liaison utilisées pour créer un moniker qui crée l’objet réel. Pour plus d’informations, consultez BIND_OPTS. Ce paramètre peut être NULL.

[in] riid

Référence à l’identificateur d’une interface implémentée sur l’objet à créer.

[out] ppv

Adresse d’un pointeur vers l’interface spécifiée par riid sur l’objet créé.

Valeur retournée

Cette fonction peut retourner les valeurs de retour standard E_FAIL, E_OUTOFMEMORY et E_UNEXPECTED, ainsi que les valeurs suivantes.

Code de retour	Description
S_OK	L’objet a été créé avec succès.
MK_E_SYNTAX	Le paramètre pszName n’est pas un nom d’affichage correctement formé.
MK_E_NOOBJECT	L’objet identifié par ce moniker, ou un objet identifié par le moniker composite dont ce moniker fait partie, est introuvable.
MK_E_EXCEEDEDDEADLINE	L’opération de liaison n’a pas pu être effectuée dans le délai spécifié par la structure BIND_OPTS passée dans pBindOptions.
MK_E_CONNECTMANUALLY	L’opération de liaison nécessite l’aide de l’utilisateur final. Les raisons les plus courantes pour retourner cette valeur sont le fait qu’un mot de passe est nécessaire ou qu’une disquette doit être montée.
MK_E_INTERMEDIATEINTERFACENOTSUPPORTED	Un objet intermédiaire a été trouvé, mais il ne prend pas en charge une interface requise pour terminer l’opération de liaison. Par exemple, un moniker d’élément retourne cette valeur si son conteneur ne prend pas en charge l’interface IOleItemContainer .

Remarques

CoGetObject encapsule les appels aux fonctions de bibliothèque COM CreateBindCtx, MkParseDisplayName et IMoniker ::BindToObject.

Configuration requise

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

Voir aussi

BIND_OPTS

Partager via