ChangeNtmsMediaType-Funktion (ntmsapi.h)

  • Artikel

[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