Функция SHCreateThread (shlwapi.h)

Статья
08/26/2023

Создает поток.

Синтаксис

BOOL SHCreateThread(
  [in]           LPTHREAD_START_ROUTINE pfnThreadProc,
  [in, optional] void                   *pData,
  [in]           SHCT_FLAGS             flags,
  [in, optional] LPTHREAD_START_ROUTINE pfnCallback
);

Параметры

[in] pfnThreadProc

Тип: LPTHREAD_START_ROUTINE

Указатель на определяемую приложением функцию типа LPTHREAD_START_ROUTINE . Если новый поток был успешно создан, эта определяемая приложением функция вызывается в контексте этого потока. SHCreateThread не дожидается завершения функции, на которую указывает этот параметр, прежде чем вернуться к вызывающей функции. Возвращаемое значение определяемой приложением функции представляет собой код выхода потока.

[in, optional] pData

Тип: void*

Указатель на дополнительную структуру данных, определяемую приложением, которая содержит данные инициализации. Он передается в функцию, на которую указывает pfnThreadProc и, при необходимости, pfnCallback. Это значение может иметь значение NULL.

[in] flags

Тип: SHCT_FLAGS

Флаги, управляющие поведением функции. Одна или несколько констант CTF .

[in, optional] pfnCallback

Тип: LPTHREAD_START_ROUTINE

Указатель на необязательную определяемую приложением функцию типа LPTHREAD_START_ROUTINE . Эта функция вызывается в контексте созданного потока перед вызовом функции, на которую указывает pfnThreadProc . Он также получит pData в качестве аргумента. SHCreateThread будет ожидать возврата функции, на которую указывает pfnCallback , прежде чем вернуться к вызывающей. Возвращаемое значение функции, на которую указывает pfnCallback , игнорируется.

Возвращаемое значение

Тип: BOOL

Возвращает значение TRUE , если поток успешно создан, или false в противном случае. При сбое используйте GetLastError , чтобы получить определенное значение ошибки, как показано ниже.

if (!SHCreateThread(...))
{
    hr = HRESULT_FROM_WIN32( GetLastError() );
}
else
{
    ....
}

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	shlwapi.h
Библиотека	Shlwapi.lib
DLL	Shlwapi.dll (версия 5.0 или более поздняя)