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.
See Also