Função CreatePointerMoniker (objbase.h)

Cria um moniker de ponteiro com base em um ponteiro para um objeto .

Sintaxe

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

Parâmetros

[in, optional] punk

Um ponteiro para uma interface IUnknown no objeto a ser identificado pelo moniker resultante.

[out] ppmk

O endereço de uma variável de ponteiro IMoniker* que recebe o ponteiro de interface para o novo moniker de ponteiro. Quando bem-sucedida, a função chamou AddRef no moniker e o chamador é responsável por chamar Release. Quando ocorre um erro, o ponteiro de interface retornado tem um valor NULL .

Retornar valor

Essa função pode retornar os valores de retorno padrão E_OUTOFMEMORY, E_UNEXPECTED e S_OK.

Comentários

Um moniker de ponteiro encapsula um ponteiro de interface existente em um moniker que pode ser passado para essas interfaces que exigem monikers. Os monikers de ponteiro permitem que um objeto sem representação persistente participe de uma operação de associação de moniker.

Os monikers de ponteiro não são comumente usados, portanto, essa função não é frequentemente chamada.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	objbase.h
Biblioteca	Ole32.lib
DLL	Ole32.dll
Conjunto de APIs	ext-ms-win-com-ole32-l1-1-0 (introduzido em Windows 8)

Confira também

Imoniker