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

Siehe auch

LocalFree, SetThreadDescription