<Return[S]><Top>

SetHandleInformation

Declare Function Api_SetHandleInformation& Lib "kernel32" Alias "SetHandleInformation" (ByVal hObject&, ByVal dwMask&, ByVal dwFlags&)

Declare Function SetHandleInformation Lib "kernel32" Alias "SetHandleInformation" (ByVal hObject As Long, ByVal dwMask As Long, ByVal dwFlags As Long) As Long

オブジェクトハンドルの特定のプロパティに関する情報を設定する。この情報は、一連のビットフラグとして指定する。

パラメータ
hObject
    オブジェクトのハンドルを指定する。SetHandleInformation 関数は、このオブジェクトハンドルに関連付けられている情報を設定する。
    アクセストークン、イベント、ファイル、ファイルマッピング、ジョブ、メールスロット、ミューテックス(相互排他)、パイプ、プリンタ、プロセス、

    レジストリキー、セマフォ、シリアル通信デバイス、ソケット、スレッド、待機可能タイマのいずれかのオブジェクトタイプのハンドルが指定でき

    る。
    Windows 2000:コンソール入力バッファ、またはコンソール画面バッファのハンドルを指定してもかまわない。
dwMask
    変更したいビットフラグを指定するマスクを指定する。dwFlags パラメータと同じフラグ定数を使う。
dwFlags
    オブジェクトハンドルのプロパティを指定する一連のビットフラグを指定する。次のフラグが定義されている。

    定数                                                               

意味                                                                                                            

    HANDLE_FLAG_INHERIT

 

このフラグがセットされていると、 関数の bInheritHandles パラメータを TRUE に設定して作成された子プロセスは、そのオブジェクトハンドルを継承する。

    HANDLE_FLAG_PROTECT_FROM_CLOSE

 

このフラグがセットされていると、CloseHandle 関数を呼び出しても、オブジェクトハンドルは閉じない。


戻り値
    関数が成功すると、0 以外の値が返る。
    関数が失敗すると、0 が返る。拡張エラー情報を取得するには、 関数を使う。

解説
    dwFlags 内のフラグをセット、またはクリアするには、dwMask パラメータと同じ変更マスクをセットしなければならない。