CreateAntiMoniker

9/8/2008

Essa função cria e fornece um novo anti-moniker.

Syntax

WINOLEAPI CreateAntiMoniker(
  LPMONIKER FAR* ppmk
);

Parameters

• ppmk
  [out] Endereço do IMonikervariável * pointer que recebe o ponteiro interface para o novo anti-moniker. Quando bem-sucedido, a função tem chamado IUnknown::AddRef Sobre o Anti-moniker e o chamador é responsáveis por chamado IUnknown::Release. Quando ocorre um erro, o ponteiro anti-moniker é NULL.

Return Value

Essa função suporta o padrão valor de retorno E_OUTOFMEMORY, bem como o seguinte:

• S_OK
  O Anti-moniker foi criado com êxito.

Remarks

O aplicativo irá chamar esta função somente quando você estiver implementando seu próprio (monikerIMoniker interface). Se a nova classe moniker não tem nenhuma estrutura interna, ele pode usar CreateAntiMoniker Na implementação das IMoniker::Inverse método e, em seguida, verificar para um anti-moniker na implementação de IMoniker::ComposeWith.

Como o ".." Diretório em sistemas arquivo MS-DOS, que atua como o inverso para qualquer nome do diretório apenas acima-lo em um caminho, um anti-moniker atua como o inverso de um moniker simples que precede em uma composição moniker.

Um anti-moniker é usado como o inverso de identificadores de origem simples com nenhuma estrutura interna. De exemplo, as sistema-desde implementações do arquivo monikers, monikers item e monikers ponteiro todos os usar anti-monikers como seu inverso; Conseqüentemente, um anti-moniker composto para o direito de uma desses monikers redige para nada.

Um cliente moniker (um objeto que está usando um moniker para BIND para outro objeto) geralmente não conhece a classe de um determinado moniker, portanto, o cliente não pode ser se um anti-moniker é o inverso. Portanto, para get o inverso de um moniker, o cliente irá chamar IMoniker::Inverse Em vez de CreateAntiMoniker.

Para remover a última parte de uma composição moniker, o cliente irá fazer o seguinte:

1. Chamar IMoniker::Enum Sobre a composição, especificando FALSE como o primeiro parâmetro. Isso cria um enumerador que retorna os identificadores de origem componente em ordem inversa.
2. Use o enumerador para recuperar a última informação a composição.
3. Chamar IMoniker::Inverse Em que moniker. O moniker retornado por IMoniker::Inverse irá remover a última informação a composição.

Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.

Requirements

Header	objbase.h
Library	ole32.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

COM Functions