Fonction InitializeProcThreadAttributeList (processthreadsapi.h)

  • Article

Initialise la liste spécifiée d’attributs pour la création de processus et de threads.

Syntaxe

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

Paramètres

[out, optional] lpAttributeList

Liste d’attributs. Ce paramètre peut avoir la valeur NULL pour déterminer la taille de mémoire tampon requise pour prendre en charge le nombre spécifié d’attributs.

[in] dwAttributeCount

Nombre d’attributs à ajouter à la liste.

dwFlags

Ce paramètre est réservé et doit être égal à zéro.

[in, out] lpSize

Si lpAttributeList n’a pas la valeur NULL, ce paramètre spécifie la taille en octets de la mémoire tampon lpAttributeList en entrée. Lors de la sortie, ce paramètre reçoit la taille en octets de la liste d’attributs initialisée.

Si lpAttributeList a la valeur NULL, ce paramètre reçoit la taille de mémoire tampon requise en octets.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Tout d’abord, appelez cette fonction avec le paramètre dwAttributeCount défini sur le nombre maximal d’attributs que vous utiliserez et le lpAttributeList sur NULL. La fonction retourne la taille de mémoire tampon requise en octets dans le paramètre lpSize .

Note Cet appel initial retourne une erreur par défaut. Ce comportement est normal.
 
Allouez suffisamment d’espace pour les données dans la mémoire tampon lpAttributeList et appelez à nouveau la fonction pour initialiser la mémoire tampon.

Pour ajouter des attributs à la liste, appelez la fonction UpdateProcThreadAttribute . Pour spécifier ces attributs lors de la création d’un processus, spécifiez EXTENDED_STARTUPINFO_PRESENT dans le paramètre dwCreationFlag et une structure STARTUPINFOEX dans le paramètre lpStartupInfo . Notez que vous pouvez spécifier la même structure STARTUPINFOEX pour plusieurs processus enfants.

Une fois la liste terminée, appelez la fonction DeleteProcThreadAttributeList .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête processthreadsapi.h (inclure Windows.h sur Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

DeleteProcThreadAttributeList

Fonctions de processus et de thread

UpdateProcThreadAttribute