DeallocateNtmsMedia-Funktion (ntmsapi.h)

Artikel
08/25/2023

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

Die DeallocateNtmsMedia-Funktion behandelt die Seite, die den angegebenen logischen Medien zugeordnet ist.

Syntax

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

Parameter

[in] hSession

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

[in] lpMediaId

Eindeutiger Bezeichner der logischen Medien (LMID).

dwOptions

Reserviert; muss null sein.

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 Sicherheitssubsystemfehler hinweisen würden. Windows XP: NTMS_MODIFY_ACCESS zum Medienpool der Medien wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Sicherheitssubsystemfehler hinweisen würden.
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_MEDIA	Die LMID ist ungültig.
ERROR_INVALID_PARAMETER	Die Medien- oder Medienpool-ID fehlt.
ERROR_INVALID_PARTITION	Die LMID-Seite ist ungültig.
ERROR_NOT_ENOUGH_MEMORY	Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten.
ERROR_SUCCESS	Die Funktion war erfolgreich.

Hinweise

Wenn ein logisches Medium mit der DeallocateNtmsMedia-Funktion zugeordnet wird, versetzt RSM die dem logischen Medium zugeordnete Seite in den Zustand Verfügbare oder außer Betrieb gesetzte Medien. Die logischen Medien werden aus dem System gelöscht, wenn die logischen Medien zugeordnet werden.

Seiten werden bei der Deallocation außer Betrieb genommen, wenn der Seite die maximale Anzahl von Im Medienpool angegebenen Zeiten zugewiesen wurde. Nachdem sich Medien im Zustand Außer Betrieb gesetzt haben, kann sie nicht mehr zugeordnet werden.

Windows Server 2003: Wenn Medien an den kostenlosen Pool zurückgegeben werden, NTMS_USE_ACCESS in den kostenlosen Pool und NTMS_CONTROL_ACCESS zum Quellpool erforderlich ist. Wenn der kostenlose Pool nicht der Zielmedienpool ist, ist NTMS_CONTROL_ACCESS sowohl für Quell- als auch für Zielpools erforderlich.

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

AllocateNtmsMedia

Media Services-Funktionen