ChangeNtmsMediaType 関数 (ntmsapi.h)

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

ChangeNtmsMediaType 関数は、指定した PMID を指定されたターゲットメディアプールに移動し、PMID のメディアの種類識別子をターゲットメディアプールのメディアの種類に設定します。

構文

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

[in] hSession

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

[in] lpMediaId

移動する物理メディアの一意識別子。

[in] lpPoolId

メディアの割り当て元となるメディアプールの一意識別子。

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

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

ChangeNtmsMediaType 関数は、MoveToNtmsMediaPool 関数と同じポリシーを使用してメディアを移動します (認識できないメディアは空きプールにのみ移動できます)。