MonikerRelativePathTo

9/8/2008

Essa função fornece um moniker que, quando composto no final do primeiro especificado moniker (ou um com uma estrutura semelhante), produz o moniker especificado segundo. Essa função destina-se ao uso somente por IMoniker::RelativePathTo Implementações.

Syntax

WINOLEAPI MonikerRelativePathTo(
  LPMONIKER pmkSrc,
  LPMONIKER pmkDest, 
  LPMONIKER FAR* ppmkRelPath, 
  BOOL dwReserved
);

Parameters

• pmkSrc
  [no] Ponteiro para o IMoniker interface no moniker que, quando composta com o relativo moniker a ser criado, produz pmkDest. Este moniker identifica a "origem" Do relativo moniker a ser criado.

• pmkDest
  [no] Ponteiro para o IMoniker interface no moniker ser expresso relativo para pmkSrc. Este moniker identifica o destino do relativo moniker a ser criado.

• ppmkRelPath
  [out] Endereço do IMonikervariável * pointer que recebe o ponteiro interface para o novo relativo moniker. 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 é NULL.

• dwReserved
  [no] Reservado; deve ser não-zero.

Return Value

Essa função suporta o padrão valor de retorno E_INVALIDARG, E_OUTOFMEMORY e E_UNEXPECTED, as well as o seguinte:

• S_OK
  Um significativo caminho relativo foi retornado.

• MK_S_HIM
  A forma somente do caminho relativo é a outro moniker.

• MK_E_NOTBINDABLE
  Indica que pmkSrc é um relativo moniker, such as moniker um item e deve ser composto com o moniker de seu contêiner antes uma caminho relativo pode ser determinada.

Remarks

Chamar MonikerRelativePathTo Somente na implementação de IMoniker::RelativePathTo Se você estiver implementando uma nova classe moniker.

A implementação de IMoniker::RelativePathTo deve primeiro verificar se a outro moniker é de um tipo Você reconhece e identificador de maneira especial. Caso contrário, você deve chamar MonikerRelativePathTo, passando próprio como pmkThis e a outro moniker como pmkOther. MonikerRelativePathTo Alças corretamente os casos onde o moniker é um genérico de composição.

Você deve chamar esta função somente se pmkSrc e pmkDest são os dois monikers absolutos, onde um moniker absoluto é o 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

See Also

Reference

COM Functions
IMoniker::RelativePathTo