This method of the IMoniker interface supplies a moniker that, when composed onto the end of this moniker (or one with a similar structure), yields the specified moniker.
public void RelativePathTo(IMoniker pmkOther, IMoniker[] ppmkRelPath);
The method supports the standard return values E_OUTOFMEMORY and E_UNEXPECTED, as well as the following:
S_OK -- A meaningful relative path has been returned.
MK_S_HIM -- No common prefix is shared by the two monikers and the moniker returned in ppmkRelPath is pmkOther.
MK_E_NOTBINDABLE -- This moniker is a relative moniker, such as an item moniker. This moniker must be composed with the moniker of its container before a relative path can be determined.
[in] pmkOther | Pointer to the IMoniker interface on the moniker to which a relative path should be taken. |
[out] ppmkRelPath | Address of IMoniker* pointer variable that receives the interface pointer to the relative moniker. |
Note ppmkRelPath is not returned, because this method can return many successful HRESULTs. This requires a throw in Java, which disallows return values.