SetThreadName

[funkcja] Ustawia nazwę wątku widoczną z poziomu debuggera Visual C++.

Składnia

#include <windows.h>

struct THREADNAME_INFO
{
DWORD dwType;
LPCSTR szName;
DWORD dwThreadID;
DWORD dwFlags;
};

void SetThreadName( DWORD dwThreadID, LPCSTR szThreadName );

Pola struktury

Pole struktury	Opis
DWORD dwType	Pole, którego wartość musi wynosić 0x1000
LPCSTR szName	Wskaźnik na łańcuch znaków. Wskazuje na nazwę jaka ma zostać nadana wątkowi.
DWORD dwThreadID	Identyfikator wątku, któremu ma zostać nadana nazwa. Wartość -1 oznacza wątek wywołujący.
DWORD dwFlags	Pole zarezerwowane, musi wynosić zero.

Argumenty

Argument	Opis
DWORD dwThreadID	Identyfikator wątku, któremu ma zostać nadana nazwa. Wartość -1 oznacza wątek wywołujący.
LPCSTR szThreadName	Nazwa, która ma zostać nadana wątkowi.

Opis szczegółowy

Funkcja ustawia nazwę wątku widoczną z poziomu debuggera Visual C++.

Uwaga!
Opisana funkcja oraz struktura nie znajduje się w pliku nagłówkowym windows.h. Kod funkcji oraz struktury należy dołączyć do kodu własnego projektu.

Przykład

#include <windows.h>

typedef struct tagTHREADNAME_INFO
{
DWORD dwType;
LPCSTR szName;
DWORD dwThreadID;
DWORD dwFlags;
} THREADNAME_INFO;

void SetThreadName( DWORD dwThreadID, LPCSTR szThreadName )
{
THREADNAME_INFO info;
info.dwType = 0x1000;
info.szName = szThreadName;
info.dwThreadID = dwThreadID;
info.dwFlags = 0;

__try
{
::RaiseException( 0x406D1388, 0, sizeof( info ) / sizeof( DWORD ),( DWORD * ) & info );
}
__except( EXCEPTION_CONTINUE_EXECUTION )
{
}
}

int main()
{
SetThreadName( - 1, "Główny wątek programu" );
return 0;
}

Linki zewnętrzne

http://msdn.microsoft.com/en-us/library/xcb2z8hs(v=vs.71).aspx

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.