CancelNtmsLibraryRequest-Funktion (ntmsapi.h)

Artikel
02/29/2024

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

Die CancelNtmsLibraryRequest-Funktion bricht ausstehende RSM-Anforderungen ab, z. B. Aufrufe der CleanNtmsDrive-Funktion . Wenn die Bibliothek ausgelastet ist, stellt RSM den Abbruch in die Warteschlange und gibt den Erfolg zurück.

Syntax

DWORD CancelNtmsLibraryRequest(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId
);

Parameter

[in] hSession

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

[in] lpRequestId

Eindeutiger Bezeichner der bibliotheksanforderung, die abgebrochen werden soll.

Verwenden Sie die Funktion EnumerateNtmsObject , um die Liste der vorhandenen Bibliotheksanforderungen abzurufen.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	Nur ein Administrator des RSM-Servers kann Bibliotheksanforderungen abbrechen. Dieser Fehler wird auch zurückgegeben, wenn die Anforderung derzeit behandelt wird und nicht gelöscht werden kann.
ERROR_INVALID_HANDLE	Das Sitzungshandle fehlt oder ist ungültig.
ERROR_NOT_ENOUGH_MEMORY	Während der Verarbeitung ist ein Zuordnungsfehler aufgetreten.
ERROR_OBJECT_NOT_FOUND	Die Objekt-ID der Bibliotheksanforderung wurde nicht gefunden. Dieser Fehler tritt auf, wenn die Anforderung vor dem Ausstellen des Abbruchs abgeschlossen wird oder wenn eine ungültige Anforderungs-ID angegeben wird.
ERROR_SUCCESS	Die Bibliotheksanforderung wurde für den Abbruch in die Warteschlange gestellt.

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

EnumerateNtmsObject

Bibliothekssteuerungsfunktionen

Freigeben über