CreatePointerMoniker

Creates a pointer moniker based on a pointer to an object.

WINOLEAPI CreatePointerMoniker(

LPUNKNOWN punk,

//Pointer to the interface to be used

LPMONIKER FAR *ppmk

//Indirect pointer to the moniker

);

Parameters

punk: [in] Pointer to an IUnknown interface on the object to be identified by the resulting moniker.
ppmk: [out] Indirect pointer to the IMoniker interface on the new pointer moniker. When successful, the function has called IUnknown::AddRef on the parameter and the caller is responsible for calling IUnknown::Release. When an error occurs, the returned pointer has a NULL value.

Return Values

This function supports the standard return values E_OUTOFMEMORY and E_UNEXPECTED, as well as the following:

S_OK: The pointer moniker was created successfully.

Remarks

A pointer moniker wraps an existing interface pointer in a moniker that can be passed to those interfaces that require monikers. Pointer monikers allow an object that has no persistent representation to participate in a moniker-binding operation.

Pointer monikers are not commonly used, so this function is not often called.

LPUNKNOWN punk,	//Pointer to the interface to be used
LPMONIKER FAR *ppmk	//Indirect pointer to the moniker
);