SetHandleInformation 函式 (handleapi.h)

設定物件控制碼的特定屬性。

語法

BOOL SetHandleInformation(
  [in] HANDLE hObject,
  [in] DWORD  dwMask,
  [in] DWORD  dwFlags
);

[in] hObject

要設定其資訊的物件控制碼。

您可以指定下列其中一種物件的控制碼：存取權杖、主控台輸入緩衝區、主控台畫面緩衝區、事件、檔案、檔案對應、作業、mailslot、mutex、管道、印表機、進程、登錄機碼、旗號、序列通訊裝置、通訊端、執行緒或可等候的計時器。

[in] dwMask

遮罩，指定要變更的位旗標。使用 dwFlags描述中顯示的相同常數。

[in] dwFlags

指定物件控制碼屬性的位旗標集。此參數可以是 0 或一或多個下列值。

值	意義
HANDLE_FLAG_INHERIT 0x00000001	如果設定此旗標，使用CreateProcess的bInheritHandles參數建立的子進程會繼承物件控制碼。
HANDLE_FLAG_PROTECT_FROM_CLOSE 0x00000002	如果設定此旗標，則呼叫 CloseHandle 函式將不會關閉物件控制碼。

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

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

若要在 dwFlags中設定或清除相關聯的位旗標，您必須在 dwMask中設定變更遮罩位旗標。