CreatePointerMoniker, fonction (objbase.h)

Crée un moniker de pointeur basé sur un pointeur vers un objet.

Syntaxe

HRESULT CreatePointerMoniker(
  [in, optional] LPUNKNOWN punk,
  [out]          LPMONIKER *ppmk
);

Paramètres

[in, optional] punk

Pointeur vers une interface IUnknown sur l’objet à identifier par le moniker résultant.

[out] ppmk

Adresse d’une variable de pointeur IMoniker* qui reçoit le pointeur d’interface vers le nouveau moniker de pointeur. En cas de réussite, la fonction a appelé AddRef sur le moniker et l’appelant est responsable de l’appel de Release. Lorsqu’une erreur se produit, le pointeur d’interface retourné a une valeur NULL .

Valeur retournée

Cette fonction peut retourner les valeurs de retour standard E_OUTOFMEMORY, E_UNEXPECTED et S_OK.

Remarques

Un moniker de pointeur encapsule un pointeur d’interface existant dans un moniker qui peut être passé aux interfaces qui nécessitent des monikers. Les monikers de pointeur permettent à un objet qui n’a aucune représentation persistante de participer à une opération de liaison moniker.

Les monikers de pointeur n’étant pas couramment utilisés, cette fonction n’est pas souvent appelée.

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
Ensemble d’API	ext-ms-win-com-ole32-l1-1-0 (introduit dans Windows 8)

Voir aussi

IMoniker