共用方式為

RpcBindingCreateA 函式 (rpcdce.h)

  • 發行項

RpcBindingCreate 函式會根據提供的範本建立新的快速 RPC 系結句柄。

語法

RPC_STATUS RpcBindingCreateA(
  [in]           RPC_BINDING_HANDLE_TEMPLATE_V1_A *Template,
  [in, optional] RPC_BINDING_HANDLE_SECURITY_V1_A *Security,
  [in, optional] RPC_BINDING_HANDLE_OPTIONS_V1    *Options,
  [out]          RPC_BINDING_HANDLE               *Binding
);

參數

[in] Template

RPC_BINDING_HANDLE_TEMPLATE 結構，描述這個呼叫所要建立的系結句柄。 此數據可能會在呼叫期間覆寫，因此 API 不會維護此數據的參考。 呼叫端必須在 API 傳回時釋放這個結構所使用的記憶體。

[in, optional] Security

RPC_BINDING_HANDLE_SECURITY 結構，描述此系結句柄的安全性選項。 此數據可能會在呼叫期間覆寫，因此 API 不會維護此數據的參考。 呼叫端必須在 API 傳回時釋放這個結構所使用的記憶體。

這是選擇性參數。 如果此參數設定為 NULL，則會使用 RPC_BINDING_HANDLE_SECURITY 的預設安全性設定。

[in, optional] Options

RPC_BINDING_HANDLE_OPTIONS 結構，描述系結句柄的其他選項。 此數據可能會在呼叫期間覆寫，因此 API 不會維護此數據的參考。 呼叫端必須在 API 傳回時釋放這個結構所使用的記憶體。

這是選擇性參數。 如果此參數設定為 NULL，則會使用 RPC_BINDING_HANDLE_OPTIONS 的預設選項。

[out] Binding

RPC_BINDING_HANDLE 結構，其中包含新建立的系結句柄。 如果此函式未傳回RPC_S_OK，則未定義此結構的內容。 對於非本機 RPC 呼叫，此句柄必須傳遞至 RpcBindingBind。

傳回值

此函式會在成功時傳回RPC_S_OK;否則會傳回RPC_S_* 錯誤碼。 如需這些錯誤碼的相關信息，請參閱 RPC 傳回值。

傳回碼 Description
RPC_S_OK
 已成功建立系結句柄。
RPC_S_CANNOT_SUPPORT
 已為此系結句柄要求 RPC 的過時功能。
注意 此 API 唯一支援的通訊協定序列是 ncalrpc;選擇另一個通訊協定順序會導致傳回此錯誤狀態代碼。
 
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 

備註

此 API 傳回的 RPC 系結句柄可以搭配任何其他接受系結句柄做為參數的函式使用。

不過，必須先呼叫 RpcBindingBind ，才能對系結句柄進行任何呼叫，才能讓系結句柄可供遠端呼叫使用。 RpcBindingCreate API 不會觸碰網路或嘗試與 RPC 伺服器通訊，而是直接根據範本中提供的值來建置內部數據結構。 成功傳回不表示 RPC 伺服器可供使用、可存取或正確指定。

注意

rpcdce.h 標頭會將 RpcBindingCreate 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

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

另請參閱

RPC_BINDING_HANDLE

RpcBindingBind