Specifies new values for the binding parameters stored in the bind context. Subsequent binding operations can call IBindCtx::GetBindOptions to retrieve the parameters.
HRESULT SetBindOptions(
BIND_OPTS *pbindopts //Pointer to a structure
);
This method supports the standard return value E_OUTOFMEMORY, as well as the following:
A bind context contains a block of parameters, stored in a BIND_OPTS2 or a 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.
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 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;
You can use the IBindCtx::SetBindOptions method to modify these values before using the bind context, if you want values other than the defaults. See BIND_OPTS for more information.
SetBindOptions only copies the struct 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.
Windows NT: Use version 3.1 or later.
Windows: Use Windows 95 or later.
Windows CE: Unsupported.
Header: Declared in objidl.h.
Bind_OPTS2, IBindCtx::GetBindOptions