SetNtmsMediaComplete-Funktion (ntmsapi.h)

Artikel
02/29/2024

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

Die SetNtmsMediaComplete-Funktion markiert einen Teil logischer Medien als vollständig.

Syntax

DWORD SetNtmsMediaComplete(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpMediaId
);

Parameter

[in] hSession

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

[in] lpMediaId

Eindeutiger Bezeichner eines Logischen Mediums.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS zum Medienpool der Medien wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Fehler des Sicherheitssubsystems hindeuten. Windows XP: NTMS_MODIFY_ACCESS zum Medienpool der Medien wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Fehler des Sicherheitssubsystems hindeuten.
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	Der Medienbezeichner ist ungültig.
ERROR_INVALID_MEDIA_POOL	Der Medienpool für die Medien ist ungültig.
ERROR_INVALID_PARAMETER	Der Medienbezeichner fehlt.
ERROR_INVALID_STATE	Die Medien befinden sich nicht im zugeordneten Zustand oder sind derzeit eingebunden.
ERROR_NOT_ENOUGH_MEMORY	Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten.
ERROR_SUCCESS	Die Funktion war erfolgreich.

Hinweise

Die SetNtmsMediaComplete-Funktion markiert das angegebene Medium als Vollständig. Eine Anwendung markiert das Medium als Abgeschlossen, wenn die Anwendung nicht mehr in das Medium schreibt. Vollständige Medien können nicht mit dem flag NTMS_MOUNT_WRITE eingebunden werden.

Die SetNtmsMediaComplete-Funktion wird in der Regel verwendet, wenn eine Anwendung das Ende der Medien erreicht. Medien, die eingebunden oder verwendet werden, können nicht als vollständig markiert 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

Media Services-Funktionen

MountNtmsMedia

Freigeben über