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) |