SwapNtmsMedia-Funktion (ntmsapi.h)

Artikel
02/29/2024

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

Die SwapNtmsMedia-Funktion tauscht die Seiten aus, die den beiden angegebenen LMIDs zugeordnet sind. Die angegebenen LMIDs müssen sich im gleichen Medienpool befinden.

Syntax

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

Parameter

[in] hSession

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

[in] lpMediaId1

Eindeutiger Bezeichner eines Stücks logischer Medien (LMID).

[in] lpMediaId2

Eindeutiger Bezeichner eines Stücks logischer Medien (LMID).

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS zum Medienpool eines der Medien wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Fehler des Sicherheitssubsystems hindeuten.
ERROR_BAD_FORMAT	Keine Medienbezeichnungsbibliothek erkennt die Medienbezeichnung.
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	Mindestens eine der Medien-IDs ist ungültig.
ERROR_INVALID_MEDIA_POOL	Mindestens ein Medienpool für die logischen Medien ist ungültig.
ERROR_INVALID_PARAMETER	Mindestens ein Medienbezeichner fehlt.
ERROR_NOT_ENOUGH_MEMORY	Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten.
ERROR_SUCCESS	Die Funktion war erfolgreich.

Hinweise

Die SwapNtmsMedia-Funktion wird verwendet, um physische Medien zu aktualisieren, ohne die Anwendung zu beeinträchtigen.

Die Medien für beide LMIDs dürfen nicht verwendet werden, damit diese Funktion erfolgreich ist.

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

Media Services-Funktionen

Freigeben über