ChangeNtmsMediaType-Funktion (ntmsapi.h)

Artikel
02/29/2024

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

Die ChangeNtmsMediaType-Funktion verschiebt die angegebene PMID in den angegebenen Zielmedienpool und legt den Medientypbezeichner der PMID auf den Medientyp des Zielmedienpools fest.

Syntax

DWORD ChangeNtmsMediaType(
  [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 des zu verschiebenden physischen Mediums.

[in] lpPoolId

Eindeutiger Bezeichner des Medienpools, aus dem die Medien zugeordnet werden sollen.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS an den Computer oder den Medienpool des Mediums wird verweigert. Andere Sicherheitsfehler sind möglich, würden aber auf einen Sicherheitssubsystemfehler hinweisen. Windows XP: NTMS_MODIFY_ACCESS zum Medienpool der Medien wird verweigert.
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	Die Medienpool-ID ist ungültig.
ERROR_INVALID_PARAMETER	Der Medienpool oder die Medien-ID fehlt.
ERROR_NOT_ENOUGH_MEMORY	Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten.
ERROR_SUCCESS	Die Funktion war erfolgreich.

Hinweise

Die ChangeNtmsMediaType-Funktion verwendet dieselbe Richtlinie für das Verschieben von Medien wie die MoveToNtmsMediaPool-Funktion (nicht erkannte Medien können nur in den freien Pool verschoben werden).

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

AddNtmsMediaType

DeleteNtmsMediaType

Media Services-Funktionen

Freigeben über