GetNtmsRequestOrder-Funktion (ntmsapi.h)

Artikel
08/25/2023

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

Die GetNtmsRequestOrder-Funktion ruft die Reihenfolge ab, in der die angegebene Anforderung in der Bibliothekswarteschlange verarbeitet wird.

Syntax

DWORD GetNtmsRequestOrder(
  [in]  HANDLE      hSession,
  [in]  LPNTMS_GUID lpRequestId,
  [out] LPDWORD     lpdwOrderNumber
);

Parameter

[in] hSession

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

[in] lpRequestId

Eindeutiger Bezeichner einer Bibliotheksanforderung.

[out] lpdwOrderNumber

Reihenfolge, in der diese 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 an den Computer wird verweigert. Es sind auch andere Sicherheitsfehler möglich, die jedoch auf einen Fehler des Sicherheitssubsystems hindeuten. Windows XP: Es sind keine Zugriffsrechte erforderlich.
ERROR_DATABASE_FAILURE	Auf die Datenbank kann nicht zugegriffen werden oder beschädigt werden.
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

Wenn die GetNtmsRequestOrder-Funktion null in lpdwOrderNumber zurückgibt, ist für diese Anforderung keine Reihenfolge verfügbar. Die Bestellnummer ist spezifisch für den Anforderungstyp, da die Typen in einer vordefinierten Reihenfolge verarbeitet werden.

Beispielsweise wird die NTMS_LM_DISMOUNT-Anforderung vor einer NTMS_LM_MOUNT-Anforderung verarbeitet. Innerhalb einer bestimmten Klasse von Anforderungen kann die Warteschlange jedoch sortiert werden. Die Anforderungen mit niedrigerer Reihenfolge werden zuerst verarbeitet, z. B. 1 ist die erste verarbeitete Anforderung, 2 ist die nächste verarbeitete Anforderung usw.

Sie können diese Bestellnummer, den Anforderungstyp, die Übermittlungszeit und das Übermittlungsdatum verwenden, um die Warteschlange in sortierter Reihenfolge anzuzeigen. Der Anforderungstyp, die Bestellnummer und die Übermittlungszeit sollten sortiert werden.

Derzeit werden Anforderungen auf NTMS_LM_MOUNT nach der Bestellnummer sortiert.

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

SetNtmsRequestOrder

Freigeben über