IVdsVolumeMF::D eleteAccessPath メソッド (vds.h)
[Windows 8とWindows Server 2012以降、仮想ディスク サービス COM インターフェイスは Windows Storage Management API に置き換えられます。
現在のボリュームからアクセス パスを削除します。
構文
HRESULT DeleteAccessPath(
[in] LPWSTR pwszPath,
[in] BOOL bForce
);
パラメーター
[in] pwszPath
削除するアクセス パスを含む文字列。 アクセス パスには、ドライブ文字または NTFS ボリューム上の空のディレクトリへのパスを指定できます。 ドライブ文字の場合は、末尾の円記号 ("F:" など) を含める必要があります。 ディレクトリへのパスの場合、末尾の円記号は必要ありません (例: "C:\MyFolder\MyDocuments")。
[in] bForce
TRUE の場合、ボリュームが使用中であっても、アクセス パスは無条件に削除されます。 このパラメーターは、アクセス パスがドライブ文字である場合にのみ意味があります。
戻り値
このメソッドは、E_INVALIDARGやE_OUTOFMEMORYなどの標準の HRESULT 値と、 VDS 固有の戻り値を返すことができます。 また、HRESULT_FROM_WIN32 マクロを使用して、変換されたシステム エラー コードを返すこともできます。 エラーは、VDS 自体または使用されている基になる VDS プロバイダー から発生する可能性があります。 可能な戻り値は次のとおりです。
| リターン コード/値 | 説明 |
|---|---|
|
メソッドは正常に完了しました。 |
|
パスは、システム ボリューム、ブート ボリューム、クラッシュダンプ ボリューム、休止状態ボリューム、またはページファイル ボリュームにつながります。 これらのボリュームからドライブ文字を削除することはできません。 |
|
指定したパスが見つかりません。 |
|
アクセス パスは正常に削除されましたが、エラーが発生しました。 VDS がパーティションの GUID パーティション テーブル (GPT) 属性を更新できなかったか、ドライブ文字の削除中に既定のネットワーク共有 (F$など) を削除できなかった可能性があります。 |
|
ボリュームが失敗しました。 |
|
ボリュームを含むパックにアクセスできません。 |
注釈
ボリュームに開いているハンドルがない場合、ドライブ文字はすぐに削除されます。 ただし、ボリュームに開いているハンドルがある場合は、ボリュームをロックできず、コンピューターの再起動時にドライブ文字が削除されます。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | vds.h |
| Library | Uuid.lib |