共用方式為

RpcMgmtSetComTimeout 函式 (rpcdce.h)

  • 發行項

RpcMgmtSetComTimeout函式會在系結控制碼中設定 binding-communications 逾時值。

語法

RPC_STATUS RpcMgmtSetComTimeout(
  RPC_BINDING_HANDLE Binding,
  unsigned int       Timeout
);

參數

Binding

設定逾時值的伺服器系結控制碼。

Timeout

通訊逾時值，從零到 10。 這些值不是秒數;它們代表從零到 10 的刻度相對時間量。

傳回值

值 意義
RPC_S_OK
 呼叫成功。
RPC_S_INVALID_BINDING
 系結控制碼無效。
RPC_S_INVALID_TIMEOUT
 逾時值無效。
RPC_S_WRONG_KIND_OF_BINDING
 這是作業的系結錯誤種類。
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 

備註

在 Windows XP 和 Windows 2000 中，在系結期間，RPC 執行時間會使用 15 分鐘的呼叫逾時，以及使用 RpcMgmtSetComTimeout 函式設定的逾時。 在系結之後的交換中，RPC 執行時間只會使用 RpcMgmtSetComTimeout 函式中的逾時集。 ncalrpc和ncadg_*通訊協定序列會忽略此選項。

用戶端應用程式會呼叫 RpcMgmtSetComTimeout ，以變更伺服器系結控制碼的通訊逾時值。 根據指定系結控制碼的通訊協定序列，逾時值只會作為 RPC 執行時間程式庫的提示。 每個通訊協定序列會以不同的方式解譯此設定;針對 ncacn_ip_tcp，值會用來開啟所有呼叫的 Keep-alive。 例如，針對 ncacn_ip_tcp，將 [ 逾時 ] 設定為零會指示 RPC 在 60 秒內未收到回應， (60 秒間隔為實作特定，且可能會變更) 。 在此情況下，只要執行的伺服器，用戶端呼叫就不會逾時;不過，如果伺服器失敗或遺失其 IP 位址，RPC 就會失敗呼叫。 TCP 逾時提示會在連線建立期間以及要求/回復交換期間使用。

注意 使用 TCP 逾時提示是偵測失敗伺服器的最佳作法。

在 Windows XP 中，當伺服器回應時，會關閉指定連線的保持運作。

 
為了方便起見，會針對逾時範圍中的特定值提供常數。 如需應用程式可用於逾時引數的 RPC 定義值清單，請參閱 系結逾時常數。

需求

   
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 rpcdce.h (包含 Rpc.h)
程式庫 Rpcrt4.lib
Dll Rpcrt4.dll

另請參閱

RpcMgmtInqComTimeout