GetHandleInformation 関数 (handleapi.h)

  • [アーティクル]

オブジェクト ハンドルの特定のプロパティを取得します。

構文

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

パラメーター

[in] hObject

情報を取得するオブジェクトへのハンドル。

アクセス トークン、コンソール入力バッファー、コンソール画面バッファー、イベント、ファイル、ファイル マッピング、ジョブ、mailslot、ミューテックス、パイプ、プリンター、プロセス、レジストリ キー、セマフォ、シリアル通信デバイス、ソケット、スレッド、または待機可能タイマーのいずれかへのハンドルを指定できます。

[out] lpdwFlags

オブジェクト ハンドルまたは 0 のプロパティを指定するビット フラグのセットを受け取る変数へのポインター。 次の値が定義されています。

値 意味
HANDLE_FLAG_INHERIT
0x00000001
 このフラグが設定されている場合、CreateProcess の bInheritHandles パラメーターを TRUE に設定して作成された子プロセスは、オブジェクト ハンドルを継承します。
HANDLE_FLAG_PROTECT_FROM_CLOSE
0x00000002
 このフラグが設定されている場合、 CloseHandle 関数を呼び出してもオブジェクト ハンドルは閉じられません。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー handleapi.h (Windows.h を含む)
Library Kernel32.lib
[DLL] Kernel32.dll

関連項目

CloseHandle

CreateProcess

ハンドル関数とオブジェクト関数

SetHandleInformation