<Return[G]><Top>

GlobalHandle

Declare Function Api_GlobalHandle& Lib "kernel32" Alias "GlobalHandle" (wMem As Any)

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

グローバルメモリブロック内の指定されたポインタに関連付けられたハンドルを取得する。
注意 グローバル関数は他のメモリ管理関数より低速で、提供する機能も多くはない。そのため、新しいアプリケーションは(ヒープ関数)を使う。しかし、DDE 関数とクリップボード関数では、依然としてグローバル関数が使われている。

パラメータ
pMem
    [入力]グローバルメモリブロックの最初のバイトへのポインタを指定する。このポインタは、GlobalLock 関数が返したものである。

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

解説
    GlobalAlloc 関数は、GMEM_MOVEABLE をセットしてメモリオブジェクトを割り当て、そのオブジェクトのハンドルを返す。GlobalLock 関数

    は、そのハンドルをメモリブロックへのポインタへ変換し、GlobalHandle 関数は、そのポインタをハンドルへ戻す。