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

请参阅

BIND_OPTS

BIND_OPTS2

BIND_OPTS3

IBindCtx