IBindCtx::SetBindOptions 方法 (objidl.h)
为绑定上下文中存储的绑定参数设置新值。
语法
HRESULT SetBindOptions(
[in] BIND_OPTS *pbindopts
);
parameters
[in] pbindopts
指向包含绑定参数 的BIND_OPTS3 结构的指针。
返回值
此方法可以返回E_OUTOFMEMORY和S_OK的标准返回值。
注解
绑定上下文包含大多数 IMoniker 操作通用的参数块。 这些参数不会随着复合名字对象的一部分的运算而变化。
后续绑定操作可以调用 IBindCtx::GetBindOptions 来检索这些参数。
给调用方的说明
名字对象客户端可以调用此方法, (那些使用名字对象获取指向对象) 接口指针的用户。首次使用 CreateBindCtx 函数创建绑定上下文时, BIND_OPTS 结构的字段将初始化为以下值:
cbStruct = sizeof(BIND_OPTS);
grfFlags = 0;
grfMode = STGM_READWRITE;
dwTickCountDeadline = 0;
如果需要默认值以外的值,可以使用 IBindCtx::SetBindOptions 方法修改这些值,然后再使用绑定上下文。
SetBindOptions 复制指定结构的成员,但不复制 COSERVERINFO 结构及其包含的指针。 在释放绑定上下文之前,调用方可能不会释放这些指针。
要求
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | objidl.h |