RpcBindingSetOption 函式 (rpcdce.h)

RpcBindingSetOption 函式可讓用戶端應用程式在系結句柄上指定消息佇列選項。

語法

RPC_STATUS RpcBindingSetOption(
  RPC_BINDING_HANDLE hBinding,
  unsigned long      option,
  ULONG_PTR          optionValue
);

參數

hBinding

要修改的伺服器系結。

option

要修改的系結屬性。 如需系結選項及其可能值的清單，請參閱 係結選項常數。 如需 RPC 通話逾時功能的相關信息，請參閱。

optionValue

系結屬性的新值。 請參閱＜備註＞。

傳回值

備註

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 伺服器可以服務要求時，藉此讓用戶端更快速地識別和略過無回應的伺服器。

規格需求

另請參閱

RPC 消息佇列

RpcBindingInqAuthClient

RpcBindingInqOption

RpcBindingSetAuthInfo

message