Función SHCreateThread (shlwapi.h)

Artículo
03/15/2023

Crea un subproceso.

Sintaxis

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

Parámetros

[in] pfnThreadProc

Tipo: LPTHREAD_START_ROUTINE

Puntero a una función definida por la aplicación del tipo LPTHREAD_START_ROUTINE . Si se creó correctamente un nuevo subproceso, se llama a esta función definida por la aplicación en el contexto de ese subproceso. SHCreateThread no espera a que se complete la función a la que apunta este parámetro antes de volver a su llamador. El valor devuelto de la función definida por la aplicación es el código de salida del subproceso.

[in, optional] pData

Tipo: void*

Puntero a una estructura de datos opcional definida por la aplicación que contiene datos de inicialización. Se pasa a la función a la que apunta pfnThreadProc y, opcionalmente, pfnCallback. Este valor puede ser NULL.

[in] flags

Tipo: SHCT_FLAGS

Marcas que controlan el comportamiento de la función. Una o varias de las constantes CTF .

[in, optional] pfnCallback

Tipo: LPTHREAD_START_ROUTINE

Puntero a una función opcional definida por la aplicación del tipo LPTHREAD_START_ROUTINE . Se llama a esta función en el contexto del subproceso creado antes de llamar a la función a la que apunta pfnThreadProc . También recibirá pData como argumento. SHCreateThread esperará a que la función a la que apunta pfnCallback vuelva antes de volver a su llamador. El valor devuelto de la función a la que apunta pfnCallback se omite.

Valor devuelto

Tipo: BOOL

Devuelve TRUE si el subproceso se ha creado correctamente o FALSE en caso contrario. Si se produce un error, use GetLastError para recuperar el valor de error específico como se muestra aquí.

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

Comentarios

La función a la que apunta pfnThreadProc y pfnCallback debe tener el siguiente formato.

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

El nombre de la función es arbitrario. El parámetro pData apunta a una estructura de datos definida por la aplicación con información de inicialización.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlwapi.h
Library	Shlwapi.lib
Archivo DLL	Shlwapi.dll (versión 5.0 o posterior)