Share via


IBindCtx::SetBindOptions (Compact 2013)

3/26/2014

This method specifies new values for the binding parameters stored in the bind context. Subsequent binding operations can call the IBindCtx::GetBindOptions method to retrieve the parameters.

Syntax

HRESULT SetBindOptions(
  BIND_OPTS* pbindopts
);

Parameters

  • pbindopts
    [in] Pointer to a BIND_OPTS2 or a BIND_OPTS structure containing the binding parameters.

Return Value

The following table shows the return values for this method.

Value

Description

E_OUTOFMEMORY

A standard return value.

S_OK

The parameters were stored successfully.

Remarks

A bind context contains a block of parameters, stored in a BIND_OPTS2 or BIND_OPTS structure, that are common to most IMoniker operations. These parameters do not change as the operation moves from piece to piece of a composite moniker.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Notes to Callers

This method can be called by moniker clients (those who use monikers to acquire interface pointers to objects).

When you first create a bind context by using the CreateBindCtx function, the fields of the BIND_OPTS structure are initialized to the following values.

    cbStruct = sizeof(BIND_OPTS); 
    grfFlags = 0; 
    grfMode = STGM_READWRITE; 
    dwTickCountDeadline = 0; 

If you want values other than the defaults, you can use the IBindCtx::SetBindOptions method to modify these values before using the bind context. See BIND_OPTS for more information.

SetBindOptions copies only the members of BIND_OPTS2, but not the COSERVERINFO structure and the pointers it contains. Callers may not free any of these pointers until the bind context is released.

Requirements

Header

objidl.h,
objidl.idl

Library

ole32.lib,
uuid.lib

See Also

Reference

IBindCtx
CreateBindCtx
IMoniker
IBindCtx::GetBindOptions
BIND_OPTS
BIND_OPTS2
COSERVERINFO