次の方法で共有

MoveToNtmsMediaPool 関数 (ntmsapi.h)

  • [アーティクル]

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

MoveToNtmsMediaPool 関数は、指定したメディアを現在のメディア プールから指定されたメディア プールに移動します。

構文

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

パラメーター

[in] hSession

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

[in] lpMediaId

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

[in] lpPoolId

宛先メディア プールの一意識別子。

戻り値

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

値 意味
ERROR_ACCESS_DENIED
 メディアのメディア プールへのNTMS_CONTROL_ACCESSは拒否されます。 その他のセキュリティ エラーも考えられますが、セキュリティ サブシステム エラーを示します。

Windows XP: ソース メディアのメディア プールまたは宛先メディア プールへのNTMS_MODIFY_ACCESSが拒否されました。 その他のセキュリティ エラーも考えられますが、セキュリティ サブシステム エラーを示します。
ERROR_BUSY
 メディアの少なくとも 1 つの側が使用中か、現在使用できません。
ERROR_DATABASE_FAILURE
 データベースにアクセスできないか、破損しています。
ERROR_DATABASE_FULL
 データベースがいっぱいです。
ERROR_INVALID_HANDLE
 セッション ハンドルがないか、無効です。
ERROR_INVALID_MEDIA_POOL
 宛先メディア プールが無効です。メディア プールが存在しません。または、認識できないまたはインポート プール内のメディアは、空きプールにのみ移動できます。
ERROR_INVALID_MEDIA
 ソース メディアまたは暗黙的なソース メディア プールが無効です。
ERROR_INVALID_PARAMETER
 メディア ID またはメディア プール ID がありません。
ERROR_MEDIA_INCOMPATIBLE
 ソースのメディアの種類は、移行先メディア プールのメディアの種類と異なります。
ERROR_NOT_ENOUGH_MEMORY
 処理中に割り当てエラーが発生しました。
ERROR_SUCCESS
 関数は成功しました。

注釈

MoveToNtmsMediaPool 関数で指定する宛先プールは、同じメディアの種類であり、互換性のあるセキュリティを持っている必要があります。

RSM は、メディアを空きメディア プールに移動する前に、メディア上の識別子をメディアに書き込みます。

[完了]、[割り当て済み]、または [予約済み] 状態のパーティションを持つメディアは、Free メディア プールに移動できません。 メディアのすべてのパーティションがインポート状態の場合にのみ、メディアをインポート プールに移動できます。

Windows Server 2003: フリー プールがソース プールの場合は、空きプールにNTMS_USE_ACCESSし、移行先プールにNTMS_CONTROL_ACCESSする必要があります。 それ以外の場合は、ソース プールと移行先プールの両方でNTMS_CONTROL_ACCESSが必要です。 空きプールが移行先プールの場合は、ソース プールにNTMS_CONTROL_ACCESSし、空きプールにNTMS_USER_ACCESSする必要があります。 それ以外の場合は、ソース プールと移行先プールの両方でNTMS_CONTROL_ACCESSが必要です。

要件

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

こちらもご覧ください

AllocateNtmsMedia

CreateNtmsMediaPool

Media Services 関数