WTSFreeMemoryExA-Funktion (wtsapi32.h)
Gibt Arbeitsspeicher frei, der WTS_PROCESS_INFO_EX oder WTS_SESSION_INFO_1 Strukturen enthält, die einer Remotedesktopdienste-Funktion zugeordnet sind.
Syntax
BOOL WTSFreeMemoryExA(
[in] WTS_TYPE_CLASS WTSTypeClass,
[in] PVOID pMemory,
[in] ULONG NumberOfEntries
);
Parameter
[in] WTSTypeClass
Ein Wert des WTS_TYPE_CLASS Enumerationstyps, der den Typ der im Puffer enthaltenen Strukturen angibt, auf die vom pMemory Parameter verwiesen wird.
[in] pMemory
Ein Zeiger auf den Puffer, der freigegeben werden soll.
[in] NumberOfEntries
Die Anzahl der Elemente im Puffer, auf die vom pMemory Parameter verwiesen wird.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie zum Abrufen erweiterter Fehlerinformationen die GetLastError--Funktion auf.
Bemerkungen
Mehrere Remotedesktopdienste-Funktionen weisen Puffer zu, um Informationen zurückzugeben. Zum Freigeben von Puffern, die WTS_PROCESS_INFO_EX- oder WTS_SESSION_INFO_1-Strukturen enthalten, müssen Sie die WTSFreeMemoryEx--Funktion aufrufen. Um andere Puffer freizulösen, können Sie entweder die WTSFreeMemory-Funktion oder die WTSFreeMemoryEx--Funktion aufrufen.
Anmerkung
Der wtsapi32.h-Header definiert WTSFreeMemoryEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 7 |
| mindestens unterstützte Server- | Windows Server 2008 R2 |
| Zielplattform- | Fenster |
| Header- | wtsapi32.h |
| Library | Wtsapi32.lib |
| DLL- | Wtsapi32.dll |
| API-Satz | ext-ms-win-session-wtsapi32-l1-1-0 (eingeführt in Windows 8) |