RpcBindingSetOption 函式 (rpcdce.h)
RpcBindingSetOption 函式可讓用戶端應用程式在系結句柄上指定消息佇列選項。
語法
RPC_STATUS RpcBindingSetOption(
RPC_BINDING_HANDLE hBinding,
unsigned long option,
ULONG_PTR optionValue
);
參數
hBinding
要修改的伺服器系結。
option
要修改的系結屬性。 如需系結選項及其可能值的清單，請參閱 係結選項常數。 如需 RPC 通話逾時功能的相關信息，請參閱。
optionValue
系結屬性的新值。 請參閱＜備註＞。
傳回值
| 值 | 意義 |
|---|---|
|
呼叫成功。 |
|
操作系統或傳輸不支援函式。 請注意，在使用 ncacn_* 以外的任何通訊協定序列的系結句柄上呼叫 RpcBindingSetOption 將會失敗，並傳回此值。 |
備註
RPC 用戶端程式會使用 RpcBindingSetOption 來控制傳遞服務品質、呼叫記錄和呼叫存留期。 變更系結句柄屬性會影響所有遠端呼叫，直到其他 呼叫 RpcBindingSetOption 變更屬性為止。 您也可以呼叫 RpcBindingSetAuthInfo 來設定系結句柄的安全性選項。
Windowsxp： RPC 呼叫逾時功能：
呼叫 RpcBindingSetOption 函式， 並將 OptionValue 設定為 RPC_C_OPT_CALL_TIMEOUT， 而 OptionValue 設定為以毫秒為單位的逾時 (值，) 可讓開發人員設定 RPC-server 逾時，以防止線程變成無回應 RPC 伺服器的上限。 這項功能可讓開發人員無法明確取消對無回應 RPC 伺服器的呼叫。 收到每個封包時，RPC 用戶端會重設逾時定時器監視。 如果逾時過期而不接收來自伺服器的封包，RPC 用戶端會傳回RPC_S_CALL_CANCELLED。 請注意，即使用戶端會捨棄回應，RPC 伺服器最終仍可能會執行呼叫。
將 OptionValue 設定為INFINITE或零，表示無限逾時。當呼叫正在進行時，請勿從另一個線程變更此選項。 請勿嘗試重試已取消的呼叫;這樣做會增加已經沒有回應伺服器的負擔。 RPC 呼叫逾時功能僅適用於連線導向、同步 RPC 呼叫，例如 在ncacn_* 通訊協定序列上所做的呼叫。 針對數據報、異步或本機 RPC 呼叫，RPC 運行時間會忽略此選項。
RPC 呼叫逾時功能在許多情況下很有用，例如會等候忙碌 RPC 伺服器回應的使用者介面更新， (讓使用者監看時漏) ，或當許多 RPC 伺服器可以服務要求時，藉此讓用戶端更快速地識別和略過無回應的伺服器。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | rpcdce.h (包含 Rpc.h) |
| 程式庫 | Rpcrt4.lib |
| Dll | Rpcrt4.dll |