Freigeben über

AddNtmsMediaType-Funktion (ntmsapi.h)

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

Die AddNtmsMediaType-Funktion fügt den angegebenen Medientyp der angegebenen Bibliothek hinzu, wenn im Bibliotheksobjekt derzeit keine Beziehung vorhanden ist. Die Funktion erstellt dann die Systemmedienpools , wenn sie nicht vorhanden sind.

Syntax

DWORD AddNtmsMediaType(
  [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 des Medientyps, der der Bibliothek hinzugefügt werden soll.

[in] lpLibId

Eindeutiger Bezeichner der Bibliothek, der der Medientyp hinzugefügt wird.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert Bedeutung
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS der Bibliothek wird verweigert. Andere Sicherheitsfehler sind möglich, weisen jedoch auf einen Fehler des Sicherheitssubsystems hin.

Windows XP: NTMS_CONTROL_ACCESS der Bibliothek wird verweigert. Andere Sicherheitsfehler sind möglich, weisen jedoch auf einen Fehler des Sicherheitssubsystems hin.
ERROR_DATABASE_FAILURE
 Auf die Datenbank kann nicht zugegriffen werden oder ist beschädigt.
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_MEDIA
 Der Medientyp 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.

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

DeleteNtmsMediaType

Media Services-Funktionen

  • Last updated on