<Return[JKL]><Top>

LocalHandle

Declare Function Api_LocalHandle& Lib "kernel32" Alias "LocalHandle" (wMem As Any)

Declare Function LocalHandle Lib "kernel32" Alias "LocalHandle" (wMem As Any) As Long

ローカルメモリオブジェクトへのポインタに対応するハンドルを取得する。
※この関数は、16 ビット版 Windows との互換性のために提供されている。

パラメータ
pMem
    ローカルメモリオブジェクトの最初のバイトへのポインタを指定する。LocalLock 関数が返したポインタを使う。

戻り値
    関数が成功すると、指定されたローカルメモリオブジェクトのハンドルが返る。
    関数が失敗すると、NULL が返る。拡張エラー情報を取得するには、GetLastError 関数を使う。

解説
    LMEM_MOVEABLE フラグをセットして LocalAlloc 関数がローカルメモリオブジェクトを割り当てた場合、そのオブジェクトのハンドルを返

    す。LocalLock 関数はこのハンドルをそのオブジェクトのメモリブロックへのポインタに変換し、LocalHandle 関数はこのポインタを元のハン

    ドルへ変換する。