DeleteNtmsRequests-Funktion (ntmsapi.h)

Artikel
08/25/2023

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

Die DeleteNtmsRequests-Funktion löscht eine Anforderung oder eine Liste von Anforderungen aus der RSM-Datenbank. Bibliotheks- oder Operatoranforderungen, die sich in einem abgeschlossenen, fehlerhaften, abgelehnten oder abgebrochenen Zustand befinden, werden entfernt. Übermittelte Anforderungen, In die Warteschlange eingereihte Anforderungen, Warteanforderungen und laufende Anforderungen können nicht gelöscht werden.

Syntax

DWORD DeleteNtmsRequests(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwType,
  [in] DWORD       dwCount
);

Parameter

[in] hSession

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

[in] lpRequestId

Liste der Bezeichner der zu löschenden Bibliotheks- und Operatoranforderungen.

[in] dwType

Der Anforderungstyp. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
NTMS_LIBREQUEST	Bibliotheksanforderung.
NTMS_OPREQUEST	Operatoranforderung.

[in] dwCount

Anzahl der Anforderungen in der Liste.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	NTMS_MODIFY_ACCESS an den Computer wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Fehler des Sicherheitssubsystems hindeuten. Windows XP: NTMS_CONTROL_ACCESS an den Computer 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_PARAMETER	Der Typbezeichner ist ungültig.
ERROR_INVALID_HANDLE	Das Sitzungshandle fehlt oder ist ungültig.
ERROR_NOT_ENOUGH_MEMORY	Fehler bei der Speicherbelegung während der Verarbeitung.
ERROR_SUCCESS	Die Funktion wurde erfolgreich ausgeführt.

Hinweise

Wenn keine Anforderung oder Liste von Anforderungen gefunden wird, wird kein Fehler zurückgegeben.

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

Bibliothekssteuerungsfunktionen

Freigeben über