SetHandleInformation 関数 (handleapi.h)

  • [アーティクル]

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

構文

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

パラメーター

[in] hObject

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

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

[in] dwMask

変更するビット フラグを指定するマスク。 dwFlags の説明に示されているのと同じ定数を使用します。

[in] dwFlags

オブジェクト ハンドルのプロパティを指定するビット フラグのセット。 このパラメーターには、0 または次の値の 1 つ以上を指定できます。

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

戻り値

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

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

解説

dwFlags で関連付けられているビット フラグを設定またはクリアするには、dwMask で変更マスク ビット フラグを設定する必要があります。

要件

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

関連項目

CloseHandle

CreateProcess

GetHandleInformation

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