GetHandleInformation 函式 (handleapi.h)

擷取物件句柄的特定屬性。

語法

BOOL GetHandleInformation(
  [in]  HANDLE  hObject,
  [out] LPDWORD lpdwFlags
);

[in] hObject

要擷取其信息的物件句柄。

您可以指定下列其中一種物件的句柄：存取令牌、控制台輸入緩衝區、控制台畫面緩衝區、事件、檔案、檔案對應、作業、mailslot、mutex、管道、印表機、進程、登錄機碼、旗號、序列通訊裝置、套接字、線程或可等候的定時器。

[out] lpdwFlags

變數的指標，可接收指定物件句柄或 0 屬性的一組位旗標。定義下列值。

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

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

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