IBindCtx::SetBindOptions 方法 (objidl.h)

設定系結內容中儲存之系結參數的新值。

語法

HRESULT SetBindOptions(
  [in] BIND_OPTS *pbindopts
);

參數

[in] pbindopts

包含系結參數 之BIND_OPTS3 結構的指標。

傳回值

這個方法可以傳回標準傳回值E_OUTOFMEMORY和S_OK。

備註

系結內容包含大部分 IMoniker 作業通用的參數區塊。 當作業從片段移至複合 Moniker 片段時,這些參數不會變更。

後續的系結作業可以呼叫 IBindCtx::GetBindOptions 來擷取這些參數。

來電者的附注

Moniker 用戶端可以呼叫這個方法, (使用 Monikers 來取得物件) 的介面指標。

當您第一次使用 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