MoveToNtmsMediaPool-Funktion (ntmsapi.h)

Artikel
02/29/2024

[Wechselmedien-Manager ist ab Windows 7 und Windows Server 2008 R2 nicht mehr verfügbar.]

Die MoveToNtmsMediaPool-Funktion verschiebt das angegebene Medium aus dem aktuellen Medienpool in den angegebenen Medienpool.

Syntax

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

Parameter

[in] hSession

Handle für die von der OpenNtmsSession-Funktion zurückgegebene Sitzung.

[in] lpMediaId

Eindeutiger Bezeichner eines Physischen Medienteils.

[in] lpPoolId

Eindeutiger Bezeichner des Zielmedienpools.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS zum Medienpool der Medien wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Fehler des Sicherheitssubsystems hindeuten. Windows XP: NTMS_MODIFY_ACCESS zum Medienpool des Quellmediums oder zum Zielmedienpool wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Fehler des Sicherheitssubsystems hindeuten.
ERROR_BUSY	Mindestens eine Seite der Medien wird verwendet oder ist derzeit nicht verfügbar.
ERROR_DATABASE_FAILURE	Auf die Datenbank kann nicht zugegriffen werden oder beschädigt werden.
ERROR_DATABASE_FULL	Die Datenbank ist voll.
ERROR_INVALID_HANDLE	Das Sitzungshandle fehlt oder ist ungültig.
ERROR_INVALID_MEDIA_POOL	Der Zielmedienpool ist ungültig. der Medienpool nicht vorhanden ist; oder die Medien im nicht erkannten oder Importpool dürfen nur in den kostenlosen Pool verschoben werden.
ERROR_INVALID_MEDIA	Das Quellmedium oder der implizite Quellmedienpool ist ungültig.
ERROR_INVALID_PARAMETER	Die Medien-ID oder die Medienpool-ID fehlt.
ERROR_MEDIA_INCOMPATIBLE	Der Medientyp der Quelle unterscheidet sich vom Medientyp des Zielmedienpools.
ERROR_NOT_ENOUGH_MEMORY	Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten.
ERROR_SUCCESS	Die Funktion war erfolgreich.

Hinweise

Der in der MoveToNtmsMediaPool-Funktion angegebene Zielpool muss denselben Medientyp aufweisen und über kompatible Sicherheit verfügen.

RSM schreibt einen On-Media-Bezeichner in Medien, bevor die Medien in den kostenlosen Medienpool verschoben werden.

Ein Medium mit einer Partition im Status Abgeschlossen, Zugeordnet oder Reserviert wird möglicherweise nicht in den Free-Medienpool verschoben. Ein Medium kann nur dann in einen Importpool verschoben werden, wenn sich alle Partitionen des Mediums im Import-Zustand befinden.

Windows Server 2003: Wenn der freie Pool der Quellpool ist, ist NTMS_USE_ACCESS zum freien Pool und NTMS_CONTROL_ACCESS zum Zielpool erforderlich. Andernfalls ist NTMS_CONTROL_ACCESS sowohl für den Quell- als auch für den Zielpool erforderlich. Wenn der kostenlose Pool der Zielpool ist, ist NTMS_CONTROL_ACCESS zum Quellpool und NTMS_USER_ACCESS zum freien Pool erforderlich. Andernfalls ist NTMS_CONTROL_ACCESS sowohl für Quell- als auch für Zielpools erforderlich.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ntmsapi.h
Bibliothek	Ntmsapi.lib
DLL	Ntmsapi.dll

Weitere Informationen

AllocateNtmsMedia

CreateNtmsMediaPool

Media Services-Funktionen

Freigeben über