RpcBindingFree 関数 (rpcdce.h)
RpcBindingFree 関数は、バインド ハンドル リソースを解放します。
構文
RPC_STATUS RpcBindingFree(
RPC_BINDING_HANDLE *Binding
);
パラメーター
Binding
解放するサーバー バインドへのポインター。
戻り値
| 値 | 説明 |
|---|---|
|
呼び出しは成功しました。 |
|
バインド ハンドルが無効でした。 |
|
これは、操作の間違った種類のバインドでした。 |
メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。
解説
RpcBindingFree 関数は、サーバー バインド ハンドルによって使用されるメモリを解放します。 プログラムの実行中に動的に作成された参照バインディング情報も解放されます。 アプリケーションは、バインド ハンドルを使用して終了したときに RpcBindingFree 関数を呼び出します。 RPC バインド ハンドルは、ハンドルを使用するすべての呼び出しが完了するまで解放しないでください。失敗すると、予期しない結果が発生します。
バインド ハンドルは、次の関数を呼び出すことによって動的に作成されます。
- RpcBindingCopy
- RpcBindingFromStringBinding
- RpcBindingServerFromClient
- RpcServerInqBindings
- RpcNsBindingImportNext
- RpcNsBindingSelect
メモ Microsoft RPC では、 RpcBindingServerFromClient で生成されたバインド ハンドルに対して、クライアント アプリケーションまたはサーバー アプリケーションでのみ RpcBindingFree がサポートされます。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | rpcdce.h (Rpc.h を含む) |
| Library | Rpcrt4.lib |
| [DLL] | Rpcrt4.dll |