Méthode IOleObject ::GetMoniker (oleidl.h)

Article
03/01/2024

Récupère le moniker d’un objet incorporé, que l’appelant peut utiliser pour lier à l’objet.

Syntaxe

HRESULT GetMoniker(
  [in]  DWORD    dwAssign,
  [in]  DWORD    dwWhichMoniker,
  [out] IMoniker **ppmk
);

Paramètres

[in] dwAssign

Détermine comment le moniker est assigné à l'objet. En fonction de la valeur de dwAssign, IOleObject ::GetMoniker effectue l’une des opérations suivantes :

Obtient un moniker uniquement si un a déjà été affecté.
Force l’affectation d’un moniker, si nécessaire, afin de répondre à l’appel.
Obtient un moniker temporaire.

Les valeurs de dwAssign sont spécifiées dans l’énumération OLEGETMONIKER.

Note Vous ne pouvez pas passer OLEGETMONIKER_UNASSIGN lors de l’appel de IOleObject ::GetMoniker. Cette valeur est valide uniquement lors de l’appel de IOleObject ::GetMoniker.

[in] dwWhichMoniker

Spécifie la forme du moniker demandé. Les valeurs possibles sont extraites de l’énumération OLEWHICHMK.

[out] ppmk

Adresse de la variable pointeur IMoniker qui reçoit le pointeur d’interface vers le moniker de l’objet. Si une erreur se produit, ppmk doit être défini sur NULL. Chaque fois qu’un objet reçoit un appel à IOleObject ::GetMoniker, il doit augmenter le nombre de références sur ppmk. Il incombe à l’appelant d’appeler Release lorsqu’il est terminé avec ppmk.

Valeur retournée

Cette méthode retourne S_OK en cas de réussite.

Remarques

La méthode IOleObject ::GetMoniker retourne le moniker d’un objet. Comme IOleObject ::SetMoniker, cette méthode est importante uniquement dans le contexte de la gestion des liens vers des objets incorporés et même dans ce cas est facultative. Un client de lien potentiel qui nécessite la liaison du moniker d’un objet à l’objet peut appeler cette méthode pour obtenir ce moniker. L’implémentation par défaut d’IOleObject ::GetMoniker appelle IOleClientSite ::GetMoniker, renvoyant E_UNEXPECTED si l’objet n’est pas en cours d’exécution ou n’a pas de pointeur valide vers un site client.

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	oleidl.h