DeleteNtmsMediaType 函式 (ntmsapi.h)

[從 Windows 7 和 Windows Server 2008 R2 起，已不再提供卸除式儲存管理員。]

DeleteNtmsMediaType 函式會從指定的媒體櫃中刪除指定的媒體類型關聯性，前提是連結庫不包含指定媒體類型的任何實體媒體物件。

語法

DWORD DeleteNtmsMediaType(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaTypeId,
  [in] LPNTMS_GUID lpLibId
);

[in] hSession

OpenNtmsSession 函式所傳回之會話的句柄。

[in] lpMediaTypeId

要從媒體櫃中刪除之媒體類型的唯一標識碼。

[in] lpLibId

要從中刪除媒體類型之連結庫的唯一標識碼。

此函式會傳回下列其中一個值。

值	意義
ERROR_ACCESS_DENIED	連結庫NTMS_MODIFY_ACCESS遭到拒絕。可能會發生其他安全性錯誤，但表示安全性子系統錯誤。 Windowsxp： NTMS_CONTROL_ACCESS連結庫遭到拒絕。可能會發生其他安全性錯誤，但表示安全性子系統錯誤。
ERROR_DATABASE_FAILURE	資料庫無法存取或損毀。
ERROR_DATABASE_FULL	資料庫已滿。
ERROR_INVALID_HANDLE	會話句柄遺失或無效。
ERROR_INVALID_LIBRARY	連結庫標識碼無效。
ERROR_INVALID_PARAMETER	缺少媒體類型或媒體櫃標識碼。
ERROR_NOT_ENOUGH_MEMORY	處理期間發生配置失敗。
ERROR_SUCCESS	函式成功。

如果 RSM 系統中沒有指定媒體類型的實體媒體物件，而且 RSM 系統中沒有包含指定媒體類型關聯性的連結庫物件，則會刪除該媒體類型的系統媒體集區。無法刪除系統媒體集區並不會導致 DeleteNtmsMediaType 函式失敗。