Microsoft SDK for Java

BIND_OPTS Class

The BIND_OPTS class of the com.ms.com package contains parameters used during a moniker-binding operation. A BIND_OPTS structure is stored in a bind context; the same bind context is used by each component of a composite moniker during binding, allowing the same parameters to be passed to all components of a composite moniker. For more information about bind contexts, see IBindCtx.

A moniker client typically does not need to specify values for the fields of this structure. Other COM library functions do this for you. For example, the CreateBindCtx function creates a bind context with the bind options set to default values that are suitable for most situations; the BindMoniker function does the same thing when creating a bind context for use in binding a moniker. If you want to modify the values of these bind options, pass a BIND_OPTS structure to IBindCtx.SetBindOptions. Moniker implementers can pass a BIND_OPTS structure to IBindCtx.GetBindOptions to retrieve the values of these bind options.

Note   The BIND_OPTS class was added as of versions 2925 through 3167 of the Microsoft virtual machine.

public class BIND_OPTS
{
  //  Members
  public int cbStruct
  public int grfFlags;
  public int grfMode;
  public int dwTickCountDeadline;
}

Members

cbStruct The size of this structure in bytes.
grfFlags The flags that control aspects of moniker-binding operations.
grfMode The flags that should be used when opening the file that contains the object identified by the moniker. The values are taken from the STGM enumeration. The binding operation uses these flags in the call to IPersistFile.Load when loading the file. If the object is already running, these flags are ignored by the binding operation.
dwTickCountDeadline Clock time in milliseconds by which the caller would like the binding operation to be completed. This member lets the caller limit the execution time of an operation when speed is of primary importance. A value of 0 (zero) indicates that there is no deadline. Callers most often use this capability when calling IMoniker.GetTimeOfLastChange, though it can be usefully applied to other operations as well.

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