DeleteNtmsMedia 関数 (ntmsapi.h)

[リムーバブル記憶域マネージャーは、Windows 7 および Windows Server 2008 R2 以降では使用できません。

DeleteNtmsMedia 関数は、指定されたメディアへのすべての参照をデータベースから削除することで、RSM からオフラインメディアの物理部分を削除します。

構文

DWORD DeleteNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId
);

[in] hSession

OpenNtmsSession 関数によって返されるセッションを処理します。

[in] lpMediaId

物理メディアの一意識別子。

この関数は、次のいずれかの値を返します。

値	意味
ERROR_ACCESS_DENIED	コンピューターまたはメディアのメディアプールへのNTMS_MODIFY_ACCESSが拒否されました。その他のセキュリティエラーも考えられますが、セキュリティサブシステムエラーを示します。 Windows XP: メディアのメディアプールへのNTMS_MODIFY_ACCESSは拒否されます。その他のセキュリティエラーも考えられますが、セキュリティサブシステムエラーを示します。
ERROR_DATABASE_FAILURE	データベースにアクセスできないか、破損しています。
ERROR_DATABASE_FULL	データベースがいっぱいです。
ERROR_INVALID_HANDLE	セッションハンドルがないか、無効です。
ERROR_INVALID_MEDIA	メディア識別子が無効です。
ERROR_INVALID_MEDIA_POOL	メディアのメディアプールが無効です。
ERROR_INVALID_PARAMETER	メディア識別子がありません。
ERROR_INVALID_STATE	メディアがオフラインではありません。
ERROR_NOT_ENOUGH_MEMORY	処理中に割り当てエラーが発生しました。
ERROR_SUCCESS	関数は成功しました。

DeleteNtmsMedia 関数で指定されたメディアは、オフラインライブラリに配置する必要があり、割り当て済み、完了済み、または予約済みの状態の側を持たない必要があります。

DeleteNtmsMedia を使用して、紛失または破棄されたメディアを削除できます。