<Return[JKL]><Top>

LocalFlags

Declare Function Api_LocalFlags& Lib "kernel32" Alias "LocalFlags" (ByVal hMem&)

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

指定されたローカルメモリオブジェクトに関する情報を取得する。
※この関数は、16 ビット版 Windows との互換性のために提供されている。

パラメータ
hMem
    ローカルメモリオブジェクトのハンドルを指定する。LocalAlloc 関数または LocalReAlloc 関数が返したハンドルを使う。

戻り値
    関数が成功すると、確保フラグとそのメモリオブジェクトのロックカウントを指定する 32 ビット値が返る。
    関数が失敗すると、ローカルハンドルが有効ではないことを示す LMEM_INVALID_HANDLE フラグが返る。拡張エラー情報を取得するに

    は、GetLastError 関数を使う。

解説
    戻り値の下位ワード(low-order word)の下位バイト(low-order byte)は、オブジェクトのロックカウントを保持している。戻り値からロック

    カウントを取得するには、LMEM_LOCKCOUNT マスクとビットごとの AND(&)演算子を使う。LMEM_FIXED フラグをセットして割り当

    てられたメモリオブジェクトのロックカウントは、常に 0 である。
    戻り値の下位ワード(low-order word)の上位バイト(high-order byte)は、メモリオブジェクトの割り当てフラグを示す。0 または次のフラ

    グの任意の組み合わせを指定する。

    値                                  

説明                                                                                                                      

    LMEM_DISCARDABLE

 

無視される。このフラグは、16 ビット版 Windows との互換性のために提供されている。
Win32 でブロックを廃棄するには、LocalDiscard 関数を明示的に呼び出さなければならない。

    LMEM_DISCARDED

オブジェクトのメモリブロックは、すでに廃棄されている。