Función InitializeProcThreadAttributeList (processthreadsapi.h)

  • Artículo

Inicializa la lista especificada de atributos para la creación de procesos y subprocesos.

Sintaxis

BOOL InitializeProcThreadAttributeList(
  [out, optional] LPPROC_THREAD_ATTRIBUTE_LIST lpAttributeList,
  [in]            DWORD                        dwAttributeCount,
                  DWORD                        dwFlags,
  [in, out]       PSIZE_T                      lpSize
);

Parámetros

[out, optional] lpAttributeList

Lista de atributos. Este parámetro puede ser NULL para determinar el tamaño del búfer necesario para admitir el número especificado de atributos.

[in] dwAttributeCount

Recuento de atributos que se van a agregar a la lista.

dwFlags

Este parámetro está reservado y debe ser cero.

[in, out] lpSize

Si lpAttributeList no es NULL, este parámetro especifica el tamaño en bytes del búfer lpAttributeList en la entrada. En la salida, este parámetro recibe el tamaño en bytes de la lista de atributos inicializados.

Si lpAttributeList es NULL, este parámetro recibe el tamaño de búfer necesario en bytes.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

En primer lugar, llame a esta función con el parámetro dwAttributeCount establecido en el número máximo de atributos que usará y lpAttributeList en NULL. La función devuelve el tamaño de búfer necesario en bytes en el parámetro lpSize .

Nota Esta llamada inicial devolverá un error por diseño. Este es el comportamiento esperado.
 
Asigne espacio suficiente para los datos en el búfer lpAttributeList y llame a la función de nuevo para inicializar el búfer.

Para agregar atributos a la lista, llame a la función UpdateProcThreadAttribute . Para especificar estos atributos al crear un proceso, especifique EXTENDED_STARTUPINFO_PRESENT en el parámetro dwCreationFlag y una estructura STARTUPINFOEX en el parámetro lpStartupInfo . Tenga en cuenta que puede especificar la misma estructura STARTUPINFOEX en varios procesos secundarios.

Cuando haya terminado de usar la lista, llame a la función DeleteProcThreadAttributeList .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado processthreadsapi.h (incluya Windows.h en Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

DeleteProcThreadAttributeList

Funciones de proceso y subproceso

UpdateProcThreadAttribute