Microsoft SDK for Java

RelativePathTo

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.

Syntax

public void RelativePathTo(IMoniker pmkOther, IMoniker[] ppmkRelPath);

Return Values

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.

Parameters

[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.

© 1999 Microsoft Corporation. All rights reserved. Terms of use.