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

Voir aussi

IMoniker