Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[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 |
|---|---|
|
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. |
|
Auf die Datenbank kann nicht zugegriffen werden oder ist beschädigt. |
|
Das Sitzungshandle fehlt oder ist ungültig. |
|
Der Bibliotheksanforderungsbezeichner fehlt. |
|
Ein Anforderungsobjekt mit dem angegebenen Bezeichner wurde nicht gefunden. |
|
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 |