Función MonikerRelativePathTo (objbase.h)

Proporciona un moniker que, cuando se compone al final del primer moniker especificado (o uno con una estructura similar), produce el segundo moniker especificado.

Esta función está pensada para su uso solo en las implementaciones de IMoniker::RelativePathTo .

Sintaxis

HRESULT MonikerRelativePathTo(
  [in]  LPMONIKER pmkSrc,
  [in]  LPMONIKER pmkDest,
  [out] LPMONIKER *ppmkRelPath,
  [in]  BOOL      dwReserved
);

Parámetros

[in] pmkSrc

Puntero a la interfaz IMoniker en el moniker que, cuando se compone con el moniker relativo que se va a crear, genera pmkDest. Este moniker identifica el "origen" del moniker relativo que se va a crear.

[in] pmkDest

Puntero a la interfaz IMoniker del moniker que se va a expresar en relación con pmkSrc. Este moniker identifica el destino del moniker relativo que se va a crear.

[out] ppmkRelPath

Dirección de una variable de puntero IMoniker* que recibe el puntero de interfaz al nuevo moniker relativo. Cuando se ejecuta correctamente, la función ha llamado a AddRef en el moniker y el autor de la llamada es responsable de llamar a Release. Si se produce un error, el valor del puntero de interfaz es NULL.

[in] dwReserved

Este parámetro está reservado y debe ser distinto de cero.

Valor devuelto

Esta función puede devolver los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY y E_UNEXPECTED, así como los valores siguientes.

Código devuelto	Descripción
S_OK	Se ha devuelto una ruta de acceso relativa significativa.
MK_S_HIM	La única forma de la ruta de acceso relativa es el otro moniker.
MK_E_NOTBINDABLE	El parámetro pmkSrc es un moniker relativo, como un moniker de elemento, y debe estar compuesto con el moniker de su contenedor antes de que se pueda determinar una ruta de acceso relativa.

Comentarios

La implementación de IMoniker::RelativePathTo debe comprobar primero si el otro moniker es de un tipo que reconoce y controla de forma especial. Si no es así, debes llamar a MonikerRelativePathTo, pasándose como pmkThis y el otro moniker como pmkOther. MonikerRelativePathTo controla correctamente los casos en los que cualquiera de los moniker es un compuesto genérico.

Debe llamar a esta función solo si pmkSrc y pmkDest son monikers absolutos, donde un moniker absoluto es un moniker de archivo o un compuesto genérico cuyo componente situado más a la izquierda es un moniker de archivo y donde el moniker de archivo representa una ruta de acceso absoluta. No llame a esta función en monikers relativos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	objbase.h
Library	Ole32.lib
Archivo DLL	Ole32.dll

Consulte también

IMoniker::RelativePathTo