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

此參數是保留的，而且必須是零。

[in, out] lpSize

如果 lpAttributeList 不是 NULL，此參數會在輸入時以位元組為單位指定 lpAttributeList 緩衝區的大小。 在輸出時，此參數會接收初始化屬性清單的位元組大小。

如果 lpAttributeList 為 NULL，此參數會接收所需的緩衝區大小，以位元組為單位。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

首先，呼叫此函式， 並將 dwAttributeCount 參數設定為您將使用的屬性數目上限，並將 lpAttributeList 設定為 NULL。 函式會以位元組為單位傳回 lpSize 參數中所需的緩衝區大小。

注意 此初始呼叫會依設計傳回錯誤。 這是正常的現象。
 
為 lpAttributeList 緩衝區中的數據配置足夠的空間，然後再次呼叫 函式來初始化緩衝區。

若要將屬性新增至清單，請呼叫 UpdateProcThreadAttribute 函式。 若要在建立進程時指定這些屬性，請在 dwCreationFlag 參數中指定EXTENDED_STARTUPINFO_PRESENT，並在 lpStartupInfo 參數中指定 STARTUPINFOEX 結構。 請注意，您可以將相同的 STARTUPINFOEX 結構指定給多個子進程。

當您完成使用清單時，請呼叫 DeleteProcThreadAttributeList 函式。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 processthreadsapi.h (包括 Windows 7 上的 Windows.h、Windows Server 2008 Windows Server 2008 R2)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

DeleteProcThreadAttributeList

處理序和執行緒函式

UpdateProcThreadAttribute