GetNtmsRequestOrder-Funktion (ntmsapi.h)

  • Artikel

[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