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:
- 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.
- Use o enumerador para recuperar a última parte da composição.
- 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) |