Export (0) Print
Expand All
1 out of 1 rated this helpful - Rate this topic

SHCreateThread function

Creates a thread.

Syntax


BOOL SHCreateThread(
  _In_      LPTHREAD_START_ROUTINE pfnThreadProc,
  _In_opt_  void *pData,
  _In_      SHCT_FLAGS dwFlags,
  _In_opt_  LPTHREAD_START_ROUTINE pfnCallback
);

Parameters

pfnThreadProc [in]

Type: LPTHREAD_START_ROUTINE

A pointer to an application-defined function of the LPTHREAD_START_ROUTINE type. If a new thread was successfully created, this application-defined function is called in the context of that thread. SHCreateThread does not wait for the function pointed to by this parameter to complete before returning to its caller. The application-defined function's return value is the exit code of the thread.

pData [in, optional]

Type: void*

A pointer to an optional application-defined data structure that contains initialization data. It is passed to the function pointed to by pfnThreadProc and, optionally, pfnCallback. This value can be NULL.

dwFlags [in]

Type: SHCT_FLAGS

The flags that control the behavior of the function. One or more of the CTF constants.

pfnCallback [in, optional]

Type: LPTHREAD_START_ROUTINE

A pointer to an optional application-defined function of the LPTHREAD_START_ROUTINE type. This function is called in the context of the created thread before the function pointed to by pfnThreadProc is called. It will also receive pData as its argument. SHCreateThread will wait for the function pointed to by pfnCallback to return before returning to its caller. The return value of the function pointed to by pfnCallback is ignored.

Return value

Type: BOOL

Returns TRUE if the thread is successfully created, or FALSE otherwise. On failure, use GetLastError to retrieve the specific error value as shown here.


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

Remarks

The function pointed to by pfnThreadProc and pfnCallback must take the following form.


DWORD WINAPI ThreadProc(LPVOID pData)
{
  ...
}

The function name is arbitrary. The pData parameter points to an application-defined data structure with initialization information.

Requirements

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Shlwapi.h

Library

Shlwapi.lib

DLL

Shlwapi.dll (version 5.0 or later)

See also

CreateThread
CreateProcess
SHCreateThreadRef
SHSetThreadRef
SHGetThreadRef
SHReleaseThreadRef
Shell and Common Controls Versions

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.