Função MonikerCommonPrefixWith (objbase.h)

Cria um novo moniker com base no prefixo comum que esse moniker (aquele que inclui os dados desse objeto moniker) compartilha com outro moniker.

Essa função destina-se a ser chamada somente em implementações de IMoniker::CommonPrefixWith.

Sintaxe

HRESULT MonikerCommonPrefixWith(
  [in]  LPMONIKER pmkThis,
  [in]  LPMONIKER pmkOther,
  [out] LPMONIKER *ppmkCommon
);

Parâmetros

[in] pmkThis

Um ponteiro para a interface IMoniker em um dos monikers para os quais um prefixo comum é procurado; geralmente o moniker no qual essa chamada é usada para implementar IMoniker::CommonPrefixWith.

[in] pmkOther

Um ponteiro para a interface IMoniker no moniker a ser comparado com o primeiro moniker.

[out] ppmkCommon

O endereço de uma variável de ponteiro IMoniker* que recebe o ponteiro de interface para o moniker com base no prefixo comum de pmkThis e pmkOther. Quando bem-sucedida, a função chamou AddRef no moniker e o chamador é responsável por chamar Release. Se ocorrer um erro, o valor do ponteiro de interface fornecido será NULL.

Retornar valor

Essa função pode retornar os valores de retorno padrão E_OUTOFMEMORY e E_UNEXPECTED, bem como os valores a seguir.

Comentários

Sua implementação de IMoniker::CommonPrefixWith deve primeiro marcar se o outro moniker é de um tipo que você reconhece e manipula de maneira especial. Caso contrário, você deve chamar MonikerCommonPrefixWith, passando-se como pmkThis e o outro moniker como pmkOther. MonikerCommonPrefixWith manipula corretamente os casos em que qualquer moniker é uma composição genérica.

Você deverá chamar essa função somente se pmkThis e pmkOther forem monikers absolutos (em que um moniker absoluto é um moniker de arquivo ou uma composição genérica cujo componente mais à esquerda é um moniker de arquivo e onde o moniker de arquivo representa um caminho absoluto). Não chame essa função em monikers relativos.

Requisitos

Confira também

IMoniker::CommonPrefixWith