UnlockFileEx

指定したファイル内の領域をアンロックする。本関数は同期・非同期のどちらでも動作できる。

UnlockFileEx hFile, dwReserved, nNumberOfBytesToUnlockLow, nNumberOfBytesToUnlockHigh, lpOverlapped

hFile : [intptr] ファイルのハンドル。GENERIC_READ または GENERIC_WRITE アクセス権で作成されている必要がある。詳細は File Security and Access Rights を参照。
dwReserved : [int] 予約パラメータ。0 でなければならない。
nNumberOfBytesToUnlockLow : [int] アンロックするバイト範囲の長さの下位部分。
nNumberOfBytesToUnlockHigh : [int] アンロックするバイト範囲の長さの上位部分。
lpOverlapped : [var] アンロック要求に使う OVERLAPPED 構造体へのポインタ。アンロック範囲の先頭ファイルオフセットを含む。hEvent メンバには有効なハンドルか 0 を初期化する。詳細は Synchronous and Asynchronous I/O を参照。

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

解説

指定したファイル内の領域をアンロックする。本関数は同期・非同期のどちらでも動作できる。

[戻り値]
関数が成功した場合、戻り値は 0 以外である。関数が失敗した場合、戻り値は 0 または NULL となる。拡張エラー情報を取得するには
GetLastError を呼ぶ。

[備考]
ファイル領域をアンロックすると以前取得したロックが解放される。アンロック領域は既存ロック領域と完全に一致する必要がある。隣接する 2
領域を別々にロックして両方をまたぐ単一領域でアンロックすることはできない。ロックは CloseHandle
の処理完了前に解放される。Windows 8 と Windows Server 2012 では本関数は次の技術によりサポートされる。
（以下省略）

情報