RpcBindingFree 函式 (rpcdce.h)

RpcBindingFree函式會釋放系結控制碼資源。

語法

RPC_STATUS RpcBindingFree(
  RPC_BINDING_HANDLE *Binding
);

參數

Binding

要釋放之伺服器系結的指標。

傳回值

值	意義
RPC_S_OK	呼叫成功。
RPC_S_INVALID_BINDING	系結控制碼無效。
RPC_S_WRONG_KIND_OF_BINDING	這是作業的系結錯誤種類。

 

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

 

備註

RpcBindingFree函式會釋放伺服器系結控制碼所使用的記憶體。 程式執行期間動態建立的參考系結資訊也會釋出。 應用程式在使用系結控制碼完成時呼叫 RpcBindingFree 函式。 除非所有使用控制碼的呼叫都已完成，否則不得釋放 RPC 系結控制碼;失敗會導致無法預測的結果。

藉由呼叫下列函式，會動態建立系結控制碼：

• RpcBindingCopy
• RpcBindingFromStringBinding
• RpcBindingServerFromClient
• RpcServerInqBindings
• RpcNsBindingImportNext
• RpcNsBindingSelect

如果作業成功釋放系結， Binding 參數會傳回 Null的值。

注意 Microsoft RPC 僅支援用戶端應用程式中的 RpcBindingFree ，或在伺服器應用程式中支援使用 RpcBindingServerFromClient 產生的系結控制碼。

 

需求

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

另請參閱

RpcBindingCopy

RpcBindingFromStringBinding

RpcBindingVectorFree

RpcNsBindingImportNext

RpcNsBindingLookupNext

RpcNsBindingSelect

RpcServerInqBindings