IBindCtx::SetBindOptions (Windows CE 5.0)
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.
HRESULT SetBindOptions(BIND_OPTS* pbindopts);
Parameters
- pbindopts
[in] Pointer to a BIND_OPTS2 or a BIND_OPTS structure containing the binding parameters.
Return Values
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
OS Versions: Windows CE 2.0 and later.
Header: Objidl.h, Objidl.idl.
Link Library: Ole32.lib, Uuid.lib.
See Also
CreateBindCtx | IMoniker | IBindCtx::GetBindOptions | BIND_OPTS | BIND_OPTS2 | COSERVERINFO
Send Feedback on this topic to the authors