Funzione InitializeProcThreadAttributeList (processthreadsapi.h)

  • Articolo

Inizializza l'elenco di attributi specificato per la creazione di processi e thread.

Sintassi

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

Parametri

[out, optional] lpAttributeList

Elenco di attributi. Questo parametro può essere NULL per determinare le dimensioni del buffer necessarie per supportare il numero specificato di attributi.

[in] dwAttributeCount

Conteggio degli attributi da aggiungere all'elenco.

dwFlags

Questo parametro è riservato e deve essere zero.

[in, out] lpSize

Se lpAttributeList non è NULL, questo parametro specifica le dimensioni in byte del buffer lpAttributeList all'input. Nell'output, questo parametro riceve le dimensioni in byte dell'elenco di attributi inizializzati.

Se lpAttributeList è NULL, questo parametro riceve le dimensioni del buffer necessarie in byte.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Chiamare prima di tutto questa funzione con il parametro dwAttributeCount impostato sul numero massimo di attributi che verranno usati e l'attributo lpAttributeList su NULL. La funzione restituisce le dimensioni del buffer necessarie in byte nel parametro lpSize .

Nota Questa chiamata iniziale restituirà un errore in base alla progettazione. Si tratta di un comportamento previsto.
 
Allocare spazio sufficiente per i dati nel buffer lpAttributeList e chiamare di nuovo la funzione per inizializzare il buffer.

Per aggiungere attributi all'elenco, chiamare la funzione UpdateProcThreadAttribute . Per specificare questi attributi durante la creazione di un processo, specificare EXTENDED_STARTUPINFO_PRESENT nel parametro dwCreationFlag e una struttura STARTUPINFOEX nel parametro lpStartupInfo . Si noti che è possibile specificare la stessa struttura STARTUPINFOEX in più processi figlio.

Al termine dell'uso dell'elenco, chiamare la funzione DeleteProcThreadAttributeList .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione processthreadsapi.h (includere Windows.h in Windows 7, Windows Server 2008 Windows Server 2008 R2)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

DeleteProcThreadAttributeList

Funzioni di processi e thread

UpdateProcThreadAttribute