InitializeProcThreadAttributeList-Funktion (processthreadsapi.h)
Initialisiert die angegebene Liste von Attributen für die Prozess- und Threaderstellung.
Syntax
BOOL InitializeProcThreadAttributeList(
[out, optional] LPPROC_THREAD_ATTRIBUTE_LIST lpAttributeList,
[in] DWORD dwAttributeCount,
DWORD dwFlags,
[in, out] PSIZE_T lpSize
);
Parameter
[out, optional] lpAttributeList
Die Attributliste. Dieser Parameter kann NULL sein, um die Puffergröße zu bestimmen, die erforderlich ist, um die angegebene Anzahl von Attributen zu unterstützen.
[in] dwAttributeCount
Die Anzahl der Attribute, die der Liste hinzugefügt werden sollen.
dwFlags
Dieser Parameter ist reserviert und muss null sein.
[in, out] lpSize
Wenn lpAttributeList nicht NULL ist, gibt dieser Parameter die Größe des puffers lpAttributeList bei der Eingabe in Bytes an. Bei der Ausgabe empfängt dieser Parameter die Größe der initialisierten Attributliste in Bytes.
Wenn lpAttributeList NULL ist, empfängt dieser Parameter die erforderliche Puffergröße in Bytes.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Rufen Sie zunächst diese Funktion auf, wobei der dwAttributeCount-Parameter auf die maximale Anzahl von Attributen festgelegt ist, die Sie verwenden werden, und die lpAttributeList auf NULL. Die Funktion gibt die erforderliche Puffergröße in Bytes im lpSize-Parameter zurück.
Um der Liste Attribute hinzuzufügen, rufen Sie die Funktion UpdateProcThreadAttribute auf. Um diese Attribute beim Erstellen eines Prozesses anzugeben, geben Sie EXTENDED_STARTUPINFO_PRESENT im dwationCreationFlag-Parameter und eine STARTUPINFOEX-Struktur im lpStartupInfo-Parameter an. Beachten Sie, dass Sie dieselbe STARTUPINFOEX-Struktur für mehrere untergeordnete Prozesse angeben können.
Wenn Sie die Liste verwendet haben, rufen Sie die DeleteProcThreadAttributeList-Funktion auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | processthreadsapi.h (einschließlich Windows.h unter Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |