Fonction InitializeProcThreadAttributeList (processthreadsapi.h)
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 .
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 |