GetNtmsRequestOrder, fonction (ntmsapi.h)
[Le Gestionnaire de stockage amovible n’est plus disponible à partir de Windows 7 et Windows Server 2008 R2.]
La fonction GetNtmsRequestOrder obtient l’ordre de traitement de la demande spécifiée dans la file d’attente de bibliothèque.
Syntaxe
DWORD GetNtmsRequestOrder(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpRequestId,
[out] LPDWORD lpdwOrderNumber
);
Paramètres
[in] hSession
Gérez la session retournée par la fonction OpenNtmsSession .
[in] lpRequestId
Identificateur unique d’une demande de bibliothèque.
[out] lpdwOrderNumber
Ordre dans lequel cette 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
Si la fonction GetNtmsRequestOrder retourne zéro dans lpdwOrderNumber, le classement n’est pas disponible pour cette requête. Le numéro de commande est spécifique au type de requête, car les types sont traités dans un ordre prédéterminé.
Par exemple, la 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 requêtes de moindre ordre sont traitées en premier, par exemple, 1 est la première demande traitée, 2 est la demande suivante traitée, et ainsi de suite.
Vous pouvez utiliser ce numéro de commande, le type de demande, l’heure de soumission et la date de soumission pour vous aider à afficher la file d’attente dans l’ordre trié. Le type de demande, le numéro de commande et l’heure de soumission doivent effectuer le tri.
Actuellement sur NTMS_LM_MOUNT, les demandes sont triées à l’aide du numéro de commande.
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 |