Fonction MonikerRelativePathTo (objbase.h)

Fournit un moniker qui, lorsqu’il est composé à la fin du premier moniker spécifié (ou d’un moniker avec une structure similaire), produit le deuxième moniker spécifié.

Cette fonction est destinée uniquement aux implémentations IMoniker ::RelativePathTo .

Syntaxe

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

Paramètres

[in] pmkSrc

Pointeur vers l’interface IMoniker sur le moniker qui, lorsqu’il est composé avec le moniker relatif à créer, produit pmkDest. Ce moniker identifie la « source » du moniker relatif à créer.

[in] pmkDest

Pointeur vers l’interface IMoniker sur le moniker à exprimer par rapport à pmkSrc. Ce moniker identifie la destination du moniker relatif à créer.

[out] ppmkRelPath

Adresse d’une variable de pointeur IMoniker* qui reçoit le pointeur d’interface vers le nouveau moniker relatif. En cas de réussite, la fonction a appelé AddRef sur le moniker et l’appelant est responsable de l’appel de Release. Si une erreur se produit, la valeur du pointeur d’interface est NULL.

[in] dwReserved

Ce paramètre est réservé et doit être différent de zéro.

Valeur retournée

Cette fonction peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY et E_UNEXPECTED, ainsi que les valeurs suivantes.

Remarques

Votre implémentation de IMoniker ::RelativePathTo doit d’abord case activée si l’autre moniker est d’un type que vous reconnaissez et gérez d’une manière spéciale. Si ce n’est pas le cas, vous devez appeler MonikerRelativePathTo, en se transmettant lui-même comme pmkThis et l’autre moniker comme pmkOther. MonikerRelativePathTo gère correctement les cas où l’un des deux moniker est un composite générique.

Vous devez appeler cette fonction uniquement si pmkSrc et pmkDest sont tous deux des monikers absolus, où un moniker absolu est un moniker de fichier ou un composite générique dont le composant le plus à gauche est un moniker de fichier, et où le moniker de fichier représente un chemin absolu. N’appelez pas cette fonction sur les monikers relatifs.

Configuration requise

Voir aussi

IMoniker ::RelativePathTo