Fungsi InitializeProcThreadAttributeList (processthreadsapi.h)

Artikel
03/08/2023

Menginisialisasi daftar atribut yang ditentukan untuk pembuatan proses dan utas.

Sintaks

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

Parameter

[out, optional] lpAttributeList

Daftar atribut. Parameter ini dapat berupa NULL untuk menentukan ukuran buffer yang diperlukan untuk mendukung jumlah atribut yang ditentukan.

[in] dwAttributeCount

Jumlah atribut yang akan ditambahkan ke daftar.

dwFlags

Parameter ini dicadangkan dan harus nol.

[in, out] lpSize

Jika lpAttributeList bukan NULL, parameter ini menentukan ukuran dalam byte buffer lpAttributeList pada input. Pada output, parameter ini menerima ukuran dalam byte dari daftar atribut yang diinisialisasi.

Jika lpAttributeList adalah NULL, parameter ini menerima ukuran buffer yang diperlukan dalam byte.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Pertama, panggil fungsi ini dengan parameter dwAttributeCount yang diatur ke jumlah maksimum atribut yang akan Anda gunakan dan lpAttributeList ke NULL. Fungsi mengembalikan ukuran buffer yang diperlukan dalam byte dalam parameter lpSize .

Catatan Panggilan awal ini akan mengembalikan kesalahan berdasarkan desain. Ini adalah perilaku yang diharapkan.

Alokasikan cukup ruang untuk data di buffer lpAttributeList dan panggil fungsi lagi untuk menginisialisasi buffer.

Untuk menambahkan atribut ke daftar, panggil fungsi UpdateProcThreadAttribute . Untuk menentukan atribut ini saat membuat proses, tentukan EXTENDED_STARTUPINFO_PRESENT dalam parameter dwCreationFlag dan struktur STARTUPINFOEX dalam parameter lpStartupInfo . Perhatikan bahwa Anda dapat menentukan struktur STARTUPINFOEX yang sama ke beberapa proses anak.

Setelah Anda selesai menggunakan daftar, panggil fungsi DeleteProcThreadAttributeList .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	processthreadsapi.h (termasuk Windows.h pada Windows 7, Windows Server 2008 Windows Server 2008 R2)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

DeleteProcThreadAttributeList

Fungsi Proses dan Utas

UpdateProcThreadAttribute

Bagikan melalui