GetThreadDescription-Funktion (processthreadsapi.h)
Ruft die Beschreibung ab, die einem Thread zugewiesen wurde, indem SetThreadDescription aufgerufen wird.
Syntax
HRESULT GetThreadDescription(
[in] HANDLE hThread,
[out] PWSTR *ppszThreadDescription
);
Parameter
[in] hThread
Ein Handle für den Thread, für den die Beschreibung abgerufen werden soll. Das Handle muss über THREAD_QUERY_LIMITED_INFORMATION Zugriff verfügen.
[out] ppszThreadDescription
Eine Unicode-Zeichenfolge, die die Beschreibung des Threads enthält.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert das HRESULT , das einen erfolgreichen Vorgang angibt. Wenn die Funktion fehlschlägt, ist der Rückgabewert ein HRESULT, das den Fehler angibt.
Hinweise
Windows Server 2016, Windows 10 LTSB 2016 und Windows 10 Version 1607: GetThreadDescription ist nur über die dynamische Laufzeitverknüpfung in KernelBase.dll verfügbar.
Die Beschreibung für einen Thread kann sich jederzeit ändern. Beispielsweise kann ein anderer Thread die Beschreibung eines relevanten Threads ändern, während Sie versuchen, diese Beschreibung abzurufen.
Threadbeschreibungen müssen nicht eindeutig sein.
Rufen Sie die LocalFree-Methode auf, um den Arbeitsspeicher für die Threadbeschreibung freizugeben.
Beispiele
Im folgenden Beispiel wird die Beschreibung für einen Thread abgerufen, die Beschreibung ausgegeben und anschließend der Arbeitsspeicher für die Beschreibung freigegeben.
HRESULT hr = GetThreadDescription(ThreadHandle, &data);
if (SUCCEEDED(hr))
{
wprintf(“%ls\n”, data);
LocalFree(data);
}
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 10, Version 1607 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | processthreadsapi.h |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |