Microsoft SDK for Java

Reduce

This method of the IMoniker interface returns a reduced moniker; that is, another moniker that refers to the same object as this moniker but can be bound with equal or greater efficiency.

Syntax

public IMoniker Reduce(IBindCtx pbc, int dwReduceHowFar, IMoniker[] ppmkToLeft);

Return Values

The method supports the standard return values E_UNEXPECTED and E_OUTOFMEMORY, as well as the following:

S_OK -- This moniker was reduced.

MK_S_REDUCED_TO_SELF -- This moniker could not be reduced any further, so ppmkReduced indicates this moniker.

MK_E_EXCEEDEDDEADLINE -- The operation could not be completed within the time limit specified by the bind context's BIND_OPTS structure.

Parameters

[in] pbc Pointer to the IBindCtx interface on the bind context to be used in this binding operation. The bind context caches objects bound during the binding process, contains parameters that apply to all operations using the bind context, and provides the means by which the moniker implementation should retrieve information about its environment.
[in] dwReduceHowFar DWORD that specifies how far this moniker should be reduced.
[in, out] ppmkToLeft On entry, address of IMoniker* pointer variable that contains the interface pointer to moniker to the left of this moniker. This parameter is primarily used by moniker implementers to enable cooperation between the various components of a composite moniker; moniker clients can usually pass NULL.

On return, *ppmkToLeft is usually set to NULL, indicating no change in the original moniker to the left. In rare situations, *ppmkToLeft indicates a moniker, indicating that the previous moniker to the left should be disregarded and the moniker returned through *ppmkToLeft is the replacement.


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