ディスクからすべてのボリューム シャドウ コピー サービス (VSS) ハードウェア ベースのスナップショット情報をクリアします。 スナップショットはシャドウ コピーとも呼ばれます。 この要求は、Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 呼び出し元は IRQL = PASSIVE_LEVELで実行されている必要があります。
メジャー コード
入力バッファー
何一つ。
入力バッファーの長さ
何一つ。
出力バッファー
何一つ。
出力バッファーの長さ
何一つ。
状態ブロック
Information メンバーは 0 に設定されます。 状態 メンバーは、操作が成功した場合にSTATUS_SUCCESSに設定されます。 それ以外の場合、Status メンバーは適切なエラー コードに設定されます。
備考
この I/O 制御コードは、カーネル モード ドライバーまたはユーザー モード アプリケーションから発行できます。 この I/O コントロール コードがカーネル モード ドライバーから発行されると、呼び出し元は、IO_STATUS_BLOCKデータ構造を含む I/O 要求パケット (IRP) を提供します。 このデータ構造は、呼び出し元にエラー情報を返すために使用されます。 この I/O 制御コードが、DeviceIocontrol ルーチンを使用してユーザー モード アプリケーションから発行された場合、呼び出し元は、GetLastError ルーチンを呼び出すことによってエラー情報を取得できます。
この IOCTL の発行時にハンドルが使用されるディスクは、IOCTL の発行時にオフライン状態になる可能性があります。 ディスク マネージャーの Microsoft 管理コンソール (MMC) スナップインを使用してディスクがオフライン状態になると、ディスクの読み取り専用属性が設定され、この IOCTL が失敗します。 ただし、ディスク パーティション ユーティリティ (Diskpart.exe) を使用してディスクをオフライン状態にした場合、ディスクの読み取り専用属性は設定されません。 このため、ディスク パーティション ユーティリティを使用してディスクをオフライン状態にすることをお勧めします。
注 この IOCTL を使用する副作用は、ディスク管理ツールが GPT ディスク上の種類 "UNKNOWN" の追加パーティションを報告する場合があるということです。 この 256 KB のパーティションは IOCTL 操作によって作成され、復元プロセスで使用されるスナップショット パーティションです。 このパーティションは想定されており、システム管理者は無視できます。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降で使用できます。 |
| ヘッダー | ntdddisk.h (Ntdddisk.h を含む) |
| IRQL | PASSIVE_LEVEL |