GlobalReAlloc

指定したグローバルメモリオブジェクトのサイズまたは属性を変更する。サイズは増加または減少できる。

GlobalReAlloc hMem, dwBytes, uFlags

hMem : [int] 再確保するグローバルメモリオブジェクトのハンドル。このハンドルは GlobalAlloc または GlobalReAlloc 関数によって返される。
dwBytes : [int] メモリブロックの新しいサイズ（バイト単位）。uFlags が GMEM_MODIFY を指定する場合、このパラメータは無視される。
uFlags : [int] 再確保オプション。GMEM_MODIFY が指定されている場合、関数はメモリオブジェクトの属性のみを変更する（dwBytes パラメータは無視される）。それ以外の場合、関数はメモリオブジェクトを再確保する。GMEM_MODIFY をオプションで以下の値と組み合わせることができる。

(プラグイン / モジュール : kernel32.dll)

解説

指定したグローバルメモリオブジェクトのサイズまたは属性を変更する。サイズは増加または減少できる。

[戻り値]
関数が成功した場合、戻り値は再確保されたメモリオブジェクトへのハンドル。関数が失敗した場合、戻り値は
NULL。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
GlobalReAlloc
が移動可能オブジェクトを再確保する場合、戻り値はメモリオブジェクトへのハンドルである。ハンドルをポインタに変換するには
GlobalLock 関数を使用する。GlobalReAlloc
が固定オブジェクトを再確保する場合、返されるハンドルの値はメモリブロックの最初のバイトのアドレスである。メモリにアクセスするには、プロセスは戻り値を単にポインタにキャストできる。GlobalReAlloc
が失敗した場合、元のメモリは解放されず、元のハンドルとポインタは依然として有効である。

情報