<Return[G]><Top>

GlobalFlags

Declare Function Api_GlobalFlags& Lib "kernel32" Alias "GlobalFlags" (ByVal hMem&)

Declare Function GlobalFlags Lib "kernel32" Alias "GlobalFlags" (ByVal hMem As Long) As Long

指定されたグローバルメモリオブジェクトの情報を取得する。
注意 この関数は、16 ビット版 Windows との互換性を保つ目的でのみ提供されている。

パラメータ
hMem
    [入力]グローバルメモリオブジェクトのハンドルを指定する。GlobalAlloc 関数または GlobalReAlloc 関数が、このハンドルを返す。

戻り値
    関数が成功すると、メモリオブジェクトの割り当てに関する値とロックカウントを保持する 32 ビット値が返る。
    関数が失敗すると、GMEM_INVALID_HANDLE が返る。これは、指定されたグローバルハンドルが有効ではないことを意味する。拡張

    エラー情報を取得するには、 関数を使う。

解説
    戻り値の下位ワードの下位バイトは、ロックカウントを保持する。戻り値からロックカウントを取得するには、GMEM_LOCKCOUNT マスク

    (0x00FF)と、ビットごとの AND(&)演算子を使う。GMEM_FIXED フラグを指定して割り当てたメモリのロックカウントは、常に 0 である。
    戻り値の下位ワードの上位バイトは、メモリオブジェクトの割り当てに関する値を保持する。この上位バイトを取得するには、0xFF00 のマス

    クと、ビットごとの AND(&)演算子を使う。この上位バイトは、0 または次の値の組み合わせになる。

    値                                    

意味                                                                                                                            

    GMEM_DDESHARE

無視される。この値は、16 ビット版 Windows との互換性を保つ目的でのみ提供されている。

    GMEM_DISCARDABLE

無視される。この値は、16 ビット版 Windows との互換性を保つ目的でのみ提供されている。

    GMEM_DISCARDED

このオブジェクトのメモリは既に廃棄されている。