IBindCtx::SetBindOptions
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 |
|
); |
|
Parameter
pbindopts
[in] Pointer
to a BIND_OPTS2
or a BIND_OPTS
structure containing the binding parameters.
Return Values
This method
supports the standard return value E_OUTOFMEMORY, as well as the following:
S_OK
The
parameters were stored successfully.
Remarks
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.
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 using the CreateBindCtx function, the fields of
the BIND_OPTS
structure are initialized to the following values:
cbStruct = sizeof(BINDOPTS);
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.
See Also