InitializeProcThreadAttributeList-Funktion (processthreadsapi.h)

  • Artikel

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.

Hinweis Dieser anfängliche Aufruf gibt einen Designfehler zurück. Dieses Verhalten ist normal.
 
Weisen Sie genügend Speicherplatz für die Daten im puffer lpAttributeList zu, und rufen Sie die Funktion erneut auf, um den Puffer zu initialisieren.

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

Siehe auch

DeleteProcThreadAttributeList

Prozess- und Threadfunktionen

UpdateProcThreadAttribute