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 では、 RpcBindingServerFromClient で生成されたバインド ハンドルに対して、クライアント アプリケーションまたはサーバー アプリケーションでのみ RpcBindingFree がサポートされます。

 

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	rpcdce.h (Rpc.h を含む)
Library	Rpcrt4.lib
[DLL]	Rpcrt4.dll

関連項目

RpcBindingCopy

RpcBindingFromStringBinding

RpcBindingVectorFree

RpcNsBindingImportNext

RpcNsBindingLookupNext

RpcNsBindingSelect

RpcServerInqBindings