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は拒否されます。 その他のセキュリティ エラーが発生する可能性がありますが、セキュリティ サブシステム エラーを示します。

Windows XP: ライブラリへのNTMS_CONTROL_ACCESSは拒否されます。 その他のセキュリティ エラーが発生する可能性がありますが、セキュリティ サブシステム エラーを示します。
ERROR_DATABASE_FAILURE
 データベースにアクセスできないか、破損しています。
ERROR_DATABASE_FULL
 データベースがいっぱいです。
ERROR_INVALID_HANDLE
 セッション ハンドルがないか、無効です。
ERROR_INVALID_LIBRARY
 ライブラリ ID が無効です。
ERROR_INVALID_PARAMETER
 メディアの種類またはライブラリ ID がありません。
ERROR_NOT_ENOUGH_MEMORY
 処理中に割り当てエラーが発生しました。
ERROR_SUCCESS
 関数は成功しました。

注釈

RSM システムに指定されたメディア・タイプの物理メディア・オブジェクトがなく、RSM システムに指定されたメディア・タイプ関係を含むライブラリー・オブジェクトがない場合、その媒体タイプのシステム・メディア・プールは削除されます。 システム メディア プールを削除できない場合、 DeleteNtmsMediaType 関数は失敗しません。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー ntmsapi.h
Library Ntmsapi.lib
[DLL] Ntmsapi.dll

こちらもご覧ください

AddNtmsMediaType

Media Services 関数