WTSFreeMemoryExA 関数 (wtsapi32.h)
リモート デスクトップ サービス関数によって割り当てられた WTS_PROCESS_INFO_EX または WTS_SESSION_INFO_1 構造体を含むメモリを解放します。
構文
BOOL WTSFreeMemoryExA(
[in] WTS_TYPE_CLASS WTSTypeClass,
[in] PVOID pMemory,
[in] ULONG NumberOfEntries
);
パラメーター
[in] WTSTypeClass
pMemory パラメーターによって参照されるバッファーに含まれる構造体の型を指定する WTS_TYPE_CLASS 列挙型の値。
[in] pMemory
解放するバッファーへのポインター。
[in] NumberOfEntries
pMemory パラメーターによって参照されるバッファー内の要素の数。
戻り値
関数が成功した場合、戻り値は 0 以外の値になります。
関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError 関数を呼び出します。
備考
いくつかのリモート デスクトップ サービス関数は、情報を返すバッファーを割り当てます。 WTS_PROCESS_INFO_EX または WTS_SESSION_INFO_1 構造体を含むバッファーを解放するには、WTSFreeMemoryEx 関数を呼び出す必要があります。 他のバッファーを解放するには、WTSFreeMemory 関数または WTSFreeMemoryEx 関数を呼び出します。
手記
wtsapi32.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして WTSFreeMemoryEx を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 7 |
| サポートされる最小サーバー | Windows Server 2008 R2 |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | wtsapi32.h |
| ライブラリ | Wtsapi32.lib |
| DLL | Wtsapi32.dll |
| API セットの | ext-ms-win-session-wtsapi32-l1-1-0 (Windows 8 で導入) |
関連項目
WTSEnumerateProcesses の
WTSEnumerateProcessesEx の
WTSEnumerateSessions を
WTSFreeMemory を
WTSQuerySessionInformation の
WTSQueryUserConfig の