SetNtmsRequestOrder, fonction (ntmsapi.h)
[Le Gestionnaire de stockage amovible n’est plus disponible depuis Windows 7 et Windows Server 2008 R2.]
La fonction SetNtmsRequestOrder définit l’ordre dans lequel la requête spécifiée sera traitée dans la file d’attente de la bibliothèque.
Syntaxe
DWORD SetNtmsRequestOrder(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpRequestId,
[in] DWORD dwOrderNumber
);
Paramètres
[in] hSession
Handle à la session retournée par la fonction OpenNtmsSession .
[in] lpRequestId
Identificateur unique d’une demande de bibliothèque.
[in] dwOrderNumber
Commandez que la demande sera traitée dans la file d’attente.
Valeur retournée
Cette fonction retourne l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
NTMS_CONTROL_ACCESS à l’ordinateur est refusé. D’autres erreurs de sécurité sont également possibles, mais elles indiquent une erreur de sous-système de sécurité.
Windows XP : Aucun droit d’accès n’est requis. |
|
La base de données est inaccessible ou endommagée. |
|
Le handle de session est manquant ou n’est pas valide. |
|
L’identificateur de demande de bibliothèque est manquant. |
|
Impossible de trouver un objet de requête avec l’identificateur spécifié. |
|
La fonction a réussi. |
Remarques
Actuellement NTMS_LM_MOUNT demandes sont triées à l’aide du numéro de commande.
Le numéro d’ordre défini par la fonction SetNtmsRequestOrder est spécifique au type de requête, car les types sont traités dans un ordre prédéterminé. Par exemple, une demande de NTMS_LM_DISMOUNT est traitée avant une demande de NTMS_LM_MOUNT. Toutefois, dans une classe spécifique de requêtes, la file d’attente peut être ordonnée. Les demandes ordonnées inférieures sont traitées en premier ; par exemple, 1 est la première demande traitée, 2 est la requête suivante traitée, et ainsi de suite.
Pour traiter une demande immédiatement, une application peut définir le numéro de commande sur 1. Pour différer le traitement, une application doit définir le numéro de commande sur un très grand nombre ou un 0xFFFFFFFF. Le numéro d’ordre d’une demande, dont le numéro de commande est actuellement égal à zéro, ne peut pas être modifié.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | ntmsapi.h |
| Bibliothèque | Ntmsapi.lib |
| DLL | Ntmsapi.dll |