ZwUnlockFile 関数 (ntifs.h)

ZwUnlockFile ルーチンは、ファイル内のバイト範囲ロックのロックを解除します。

構文

NTSYSAPI NTSTATUS ZwUnlockFile(
  [in]  HANDLE           FileHandle,
  [out] PIO_STATUS_BLOCK IoStatusBlock,
  [in]  PLARGE_INTEGER   ByteOffset,
  [in]  PLARGE_INTEGER   Length,
  [in]  ULONG            Key
);

パラメーター

[in] FileHandle

ロックを解除するバイト範囲を持つファイルを表すファイル オブジェクトのハンドル。

[out] IoStatusBlock

最終的な状態を含む IO_STATUS_BLOCK 構造体へのポインター。

[in] ByteOffset

ロックを解除するバイト範囲の開始バイト オフセットを指定する変数へのポインター。

[in] Length

ロックを解除するバイト範囲の長さをバイト単位で指定する変数へのポインター。

[in] Key

関連するロックのグループを記述するために使用される呼び出し元割り当て値。 この値は 0 に設定する必要があります。

戻り値

ZwUnlockFile ルーチンは、成功したSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。 使用可能な NTSTATUS 値は次のとおりです。

リターン コード	説明
STATUS_RANGE_NOT_LOCKED	指定されたバイト範囲がロックされていません。

注釈

ZwUnlockFile ルーチンは、ByteOffset 引数と Length 引数で指定されたバイト範囲を受け取ります。 この範囲は、 以前に ZwUnlockFile ルーチンの 1 回の呼び出しでロックされていたファイル内のバイト範囲と同じである必要があります。 ZwUnlockFile を 1 回呼び出すと、以前にロックされていた 2 つの隣接する範囲のロックを解除することはできません。 また、ZwUnlockFile ルーチンの 1 回の呼び出しで以前にロックされていた範囲の一部をロック解除することもできません。

ZwUnlockFile の呼び出し元は、IRQL = PASSIVE_LEVEL で実行され、特殊なカーネル APCs が有効になっている必要があります**。

注意

ZwUnlockFile 関数の呼び出しがユーザー モードで行われる場合は、"ZwUnlockFile" ではなく "NtUnlockFile" という名前を使用する必要があります。

カーネル モード ドライバーからの呼び出しの場合、Windows ネイティブ システム サービス ルーチンの NtXxx および ZwXxx バージョンは、入力パラメーターを処理および解釈する方法で動作が異なる場合があります。 ルーチンの NtXxx バージョンと ZwXxx バージョンの間の関係の詳細については、「ネイティブ システム サービス ルーチンの Nt バージョンと Zw バージョンの使用」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 7
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h、FltKernel.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE_LEVEL (「解説」セクションを参照)
DDI コンプライアンス規則	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

こちらもご覧ください

ZwLockFile