SwapNtmsMedia 関数 (ntmsapi.h)

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

SwapNtmsMedia 関数は、指定された 2 つの LMID に関連付けられている辺をスワップします。指定された LMID は、同じメディアプール内に存在する必要があります。

構文

DWORD SwapNtmsMedia(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId1,
  [in] LPNTMS_GUID lpMediaId2
);

[in] hSession

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

[in] lpMediaId1

論理メディアの一意識別子 (LMID)。

[in] lpMediaId2

論理メディアの一意識別子 (LMID)。

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

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

SwapNtmsMedia 関数は、アプリケーションに影響を与えずに物理メディアを更新するために使用されます。

この関数を成功させるには、両方の LMID のメディアを使用しないでください。