rpcServerInqBindingHandle 函式 (rpcdce.h)

RpcServerInqBindingHandle函式會取得呼叫 RpcServerInqBindingHandle之執行緒所服務之 RPC 呼叫的系結控制碼。

語法

RPC_STATUS RpcServerInqBindingHandle(
  RPC_BINDING_HANDLE *Binding
);

Binding

RPC_BINDING_HANDLE 結構，在成功時，會接收 同時呼叫 RpcServerInqBindingHandle 之執行緒所服務之呼叫的系結控制碼。

如果呼叫失敗，則這個參數是未定義的。

此函式會在成功時傳回RPC_S_OK;否則，會傳回RPC_S_* 錯誤碼。除非在目前未服務 RPC 呼叫的執行緒上呼叫此函式，否則此函式無法失敗。

注意如需有效錯誤碼的清單，請參閱 RPC 傳回值。

RpcServerInqBindingHandle 可用來取得 RPC 呼叫的系結控制碼，此呼叫目前正在呼叫此 API 的執行緒上執行。由於許多 RPC API 需要系結控制碼做為輸入，因此這是取得系結控制碼的便利方式。

請注意，採用系結控制碼做為參數的所有伺服器端 RPC API 都可讓您將 Null 傳遞為可接受的值。傳遞 Null 而非系結控制碼，表示應該使用目前正在相同執行緒中執行之 RPC 呼叫的系結控制碼。不過，如果您從個別執行緒呼叫伺服器端 API，則必須提供非 Null 系結控制碼給它們。

如果您使用明確的系結控制碼，而且不使用執行緒特定的內容控制碼，呼叫的系結控制碼就是伺服器管理員常式的第一個參數。不過，如果您不使用明確控制碼，或是使用內容控制碼， RpcServerInqBindingHandle 是取得要在另一個執行緒中使用的系結控制碼的唯一方法。

雖然這個 API 可用於非同步和同步呼叫，但對於非同步呼叫而言較不實用，因為系結控制碼可以取得，因為非同步狀態一律是所有非同步 RPC 呼叫的第一個參數，而且可以使用 RpcAsyncGetCallHandle直接從它取得系結控制碼。