IBindCtx：：SetBindOptions 方法 (objidl.h)

为绑定上下文中存储的绑定参数设置新值。

语法

HRESULT SetBindOptions(
  [in] BIND_OPTS *pbindopts
);

[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 结构及其包含的指针。调用方在释放绑定上下文之前可能无法释放这些指针。