InitializeProcThreadAttributeList 함수(processthreadsapi.h)
프로세스 및 스레드 만들기를 위해 지정된 특성 목록을 초기화합니다.
구문
BOOL InitializeProcThreadAttributeList(
[out, optional] LPPROC_THREAD_ATTRIBUTE_LIST lpAttributeList,
[in] DWORD dwAttributeCount,
DWORD dwFlags,
[in, out] PSIZE_T lpSize
);
매개 변수
[out, optional] lpAttributeList
특성 목록입니다. 이 매개 변수는 지정된 수의 특성을 지원하는 데 필요한 버퍼 크기를 결정하는 NULL일 수 있습니다.
[in] dwAttributeCount
목록에 추가할 특성의 수입니다.
dwFlags
이 매개 변수는 예약되어 있으며 0이어야 합니다.
[in, out] lpSize
lpAttributeList가 NULL이 아닌 경우 이 매개 변수는 입력에서 lpAttributeList 버퍼의 크기(바이트)를 지정합니다. 출력에서 이 매개 변수는 초기화된 특성 목록의 크기(바이트)를 받습니다.
lpAttributeList가 NULL인 경우 이 매개 변수는 필요한 버퍼 크기(바이트)를 받습니다.
반환 값
함수가 성공하면 반환 값이 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
먼저 dwAttributeCount 매개 변수를 사용할 최대 특성 수로 설정하고 lpAttributeList 를 NULL로 설정하여 이 함수를 호출합니다. 함수는 lpSize 매개 변수에서 필요한 버퍼 크기를 바이트 단위로 반환합니다.
목록에 특성을 추가하려면 UpdateProcThreadAttribute 함수를 호출합니다. 프로세스를 만들 때 이러한 특성을 지정하려면 dwCreationFlag 매개 변수에 EXTENDED_STARTUPINFO_PRESENT 지정하고 lpStartupInfo 매개 변수에서 STARTUPINFOEX 구조를 지정합니다. 여러 자식 프로세스에 동일한 STARTUPINFOEX 구조를 지정할 수 있습니다.
목록 사용을 마쳤으면 DeleteProcThreadAttributeList 함수를 호출합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | processthreadsapi.h(Windows 7, Windows Server 2008 Windows Server 2008 R2에 Windows.h 포함) |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |