MonikerCommonPrefixWith
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função cria um novo moniker baseia o comum prefixo que este moniker (aquele contendo os dados do objeto moniker) compartilha com outro moniker. Essa função destina-se a ser chamado apenas em implementações de IMoniker::CommonPrefixWith.
Syntax
WINOLEAPI MonikerCommonPrefixWith(
LPMONIKER pmkThis,
LPMONIKER pmkOther,
LPMONIKER FAR* ppmkCommon
);
Parameters
- pmkThis
[no] Ponteiro para o IMoniker interface em um dos identificadores de origem para o qual um comum prefixo é procurado; Geralmente o moniker em que este chamar é usado para implementar IMoniker::CommonPrefixWith.
- pmkOther
[no] Ponteiro para o IMoniker interface sobre a outro moniker para comparar com o moniker primeiro.
ppmkCommon
[out] Endereço do IMonikervariável * pointer que recebe o ponteiro interface para o moniker baseia o comum prefixo de pmkThis e pmkOther.Quando bem-sucedido, a função tem chamado IUnknown::AddRef Sobre o moniker e o chamador é responsáveis por chamado IUnknown::Release.
Se um erro ocorrer, o valor ponteiro interface fornecida é NULL.
Return Value
O padrão oferece suporte a essa função retornar valores E_OUTOFMEMORY e E_UNEXPECTED, bem como o seguinte:
- S_OK
Um comum prefixo existe que é nenhuma pmkThis Nem pmkOther.
- MK_S_HIM
Todo o pmkOther moniker é um prefixo da pmkThis moniker.
- MK_S_ME
Todo o pmkThis moniker é um prefixo da pmkOther moniker.
- MK_S_US
O pmkThis e pmkOther identificadores de origem são iguais.
- MK_E_NOPREFIX
Os identificadores de origem tem não comum prefixo.
- MK_E_NOTBINDABLE
Essa função foi chamado em um relativo moniker. Não é significativo tenham o comum prefixo de relativo monikers.
Remarks
Chamar MonikerCommonPrefixWith Somente na implementação de IMoniker::CommonPrefixWith Para uma nova classe moniker.
A implementação de IMoniker::CommonPrefixWith deve primeiro verificar se a outro moniker é de um tipo que você reconhece e identificador de maneira especial.
Caso contrário, você deve chamar MonikerCommonPrefixWith, passando próprio como pmkThis e a outro moniker como pmkOther. MonikerCommonPrefixWith Alças corretamente os casos onde o moniker é um genérico de composição.
Você deve chamar esta função somente se pmkThis e pmkOther são os dois monikers absolutas (onde um moniker absoluta é moniker um arquivo ou um genérico composição cujo componente mais à esquerda é moniker um arquivo, e onde o moniker arquivo representa um caminho absoluto).
Fazer não chamar essa função em relativo monikers.
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 |