共用方式為

rpcBindingCopy 函式 (rpcdce.h)

  • 發行項

RpcBindingCopy 函式會複製系結資訊，並建立新的系結句柄。

語法

RPC_STATUS RpcBindingCopy(
  RPC_BINDING_HANDLE SourceBinding,
  RPC_BINDING_HANDLE *DestinationBinding
);

參數

SourceBinding

複製參考系結資訊的伺服器系結句柄。

DestinationBinding

傳回參考所複製系結資訊之伺服器系結句柄的指標。

傳回值

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

備註

RpcBindingCopy 函式會複製 SourceBinding 參數所參考的伺服器系結資訊。 RpcBindingCopy 會使用 DestinationBinding 參數傳回所複製系結資訊的新伺服器系結句柄。 RpcBindingCopy 也會將驗證資訊從 SourceBinding 參數複製到 DestinationBinding 參數。

當應用程式想要防止某個線程對系結資訊所做的變更，而不會影響其他線程所使用的系結資訊時，應用程式會使用 RpcBindingCopy 。

一旦應用程式呼叫 RpcBindingCopy， 在 SourceBinding 系結句柄上執行的作業不會影響 DestinationBinding 系結句柄所參考的系結資訊。 同樣地， 在 DestinationBinding 系結句柄上執行的作業不會影響 SourceBinding 系結句柄所參考的系結資訊。

如果應用程式想要對系結資訊進行一個線程的變更，以影響其他線程所使用的系結資訊，應用程式應該在線程之間共用單一系結句柄。 在此情況下，應用程式會負責系結句柄並行控制。

當應用程式使用 DestinationBinding 參數所指定的系結句柄完成時，應用程式應該呼叫 RpcBindingFree 函式來釋放 DestinationBinding 系結句柄所使用的記憶體及其參考的系結資訊。

注意 Microsoft RPC 僅支援用戶端應用程式中的 RpcBindingCopy ，而不是在伺服器應用程式中。
 

規格需求

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

另請參閱

RpcBindingFree