DeleteNtmsMediaType-Funktion (ntmsapi.h)

Artikel
08/25/2023

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

Die DeleteNtmsMediaType-Funktion löscht die angegebene Medientypbeziehung aus der angegebenen Bibliothek, sofern die Bibliothek keine physischen Medienobjekte des angegebenen Medientyps enthält.

Syntax

DWORD DeleteNtmsMediaType(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaTypeId,
  [in] LPNTMS_GUID lpLibId
);

Parameter

[in] hSession

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

[in] lpMediaTypeId

Eindeutiger Bezeichner eines Medientyps, der aus einer Bibliothek gelöscht werden soll.

[in] lpLibId

Eindeutiger Bezeichner der Bibliothek, aus der der Medientyp gelöscht werden soll.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS an die Bibliothek wird verweigert. Andere Sicherheitsfehler sind möglich, weisen jedoch auf einen Sicherheitssubsystemfehler hin. Windows XP: NTMS_CONTROL_ACCESS der Bibliothek wird verweigert. Andere Sicherheitsfehler sind möglich, weisen jedoch auf einen Sicherheitssubsystemfehler hin.
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_LIBRARY	Die Bibliotheks-ID ist ungültig.
ERROR_INVALID_PARAMETER	Der Medientyp oder die Bibliotheks-ID fehlt.
ERROR_NOT_ENOUGH_MEMORY	Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten.
ERROR_SUCCESS	Die Funktion war erfolgreich.

Hinweise

Wenn im RSM-System keine physischen Medienobjekte des angegebenen Medientyps vorhanden sind und keine Bibliotheksobjekte vorhanden sind, die die angegebene Medientypbeziehung im RSM-System enthalten, werden die Systemmedienpools für diesen Medientyp gelöscht. Die Unfähigkeit, die Systemmedienpools zu löschen, führt nicht dazu, dass die DeleteNtmsMediaType-Funktion fehlschlägt.

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

Media Services-Funktionen

Freigeben über