Compartilhar via


Função CreateAntiMoniker (objbase.h)

Cria e retorna um novo anti-moniker.

Sintaxe

HRESULT CreateAntiMoniker(
  [out] LPMONIKER *ppmk
);

Parâmetros

[out] ppmk

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

Retornar valor

Essa função pode retornar os valores retornados padrão E_OUTOFMEMORY e S_OK.

Comentários

Você chamaria essa função somente se estivesse escrevendo sua própria classe de moniker (implementando a interface IMoniker ). Se você estiver escrevendo uma nova classe de moniker sem estrutura interna, poderá usar CreateAntiMoniker na implementação do método IMoniker::Inverse e, em seguida, marcar para um anti-moniker na implementação de IMoniker::ComposeWith.

Como o diretório ".", que atua como o inverso a qualquer nome de diretório que apenas o precede em um caminho, um anti-moniker atua como o inverso de um moniker simples que o precede em um moniker composto. Um anti-moniker é usado como o inverso de monikers simples sem estrutura interna. Por exemplo, as implementações fornecidas pelo sistema de monikers de arquivo, monikers de item e monikers de ponteiro usam anti-monikers como seu inverso; consequentemente, um anti-moniker composto à direita de um desses monikers compõe a nada.

Um cliente moniker (um objeto que está usando um moniker para associar a outro objeto) normalmente não conhece a classe de um determinado moniker, portanto, o cliente não pode ter certeza de que um anti-moniker é o inverso. Portanto, para obter o inverso de um moniker, você chamaria IMoniker::Inverse em vez de CreateAntiMoniker.

Para remover a última parte de um moniker composto, você faria o seguinte:

  1. Chame IMoniker::Enum na composição, especificando FALSE como o primeiro parâmetro. Isso cria um enumerador que retorna os monikers de componente na ordem inversa.
  2. Use o enumerador para recuperar a última parte da composição.
  3. Chame IMoniker::Inverse nesse moniker. O moniker retornado pelo Inverso removerá a última parte da composição.

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-5 (introduzido no Windows 10, versão 10.0.15063)

Confira também

Imoniker