SetNtmsRequestOrder-Funktion (ntmsapi.h)

Artikel
08/25/2023

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

Die SetNtmsRequestOrder-Funktion legt die Reihenfolge fest, in der die angegebene Anforderung in der Bibliothekswarteschlange verarbeitet wird.

Syntax

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

Parameter

[in] hSession

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

[in] lpRequestId

Eindeutiger Bezeichner einer Bibliotheksanforderung.

[in] dwOrderNumber

Ordnen Sie an, dass die Anforderung in der Warteschlange verarbeitet wird.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Wert	Bedeutung
ERROR_ACCESS_DENIED	NTMS_CONTROL_ACCESS dem Computer wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Sicherheitssubsystemfehler hinweisen würden. Windows XP: Es sind keine Zugriffsrechte erforderlich.
ERROR_DATABASE_FAILURE	Auf die Datenbank kann nicht zugegriffen werden oder ist beschädigt.
ERROR_INVALID_HANDLE	Das Sitzungshandle fehlt oder ist ungültig.
ERROR_INVALID_PARAMETER	Der Bibliotheksanforderungsbezeichner fehlt.
ERROR_OBJECT_NOT_FOUND	Ein Anforderungsobjekt mit dem angegebenen Bezeichner wurde nicht gefunden.
ERROR_SUCCESS	Die Funktion war erfolgreich.

Hinweise

Derzeit werden NTMS_LM_MOUNT Anforderungen anhand der Bestellnummer sortiert.

Die von der SetNtmsRequestOrder-Funktion festgelegte Bestellnummer ist spezifisch für den Typ der Anforderung, da die Typen in einer vordefinierten Reihenfolge verarbeitet werden. Beispielsweise wird eine NTMS_LM_DISMOUNT-Anforderung vor einer NTMS_LM_MOUNT-Anforderung verarbeitet. Innerhalb einer bestimmten Klasse von Anforderungen kann die Warteschlange jedoch bestellt werden. Die niedriger geordneten Anforderungen werden zuerst verarbeitet. Beispielsweise ist 1 die erste verarbeitete Anforderung, 2 die nächste verarbeitete Anforderung usw.

Um eine Anforderung sofort zu verarbeiten, kann eine Anwendung die Bestellnummer auf 1 festlegen. Zum Verzögern der Verarbeitung sollte eine Anwendung die Bestellnummer auf eine sehr große Zahl oder 0xFFFFFFFF festlegen. Die Bestellnummer einer Anforderung, die derzeit über die Bestellnummer 0 verfügt, kann nicht geändert 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

GetNtmsRequestOrder

Bibliothekssteuerungsfunktionen

Freigeben über