GetNtmsRequestOrder, fonction (ntmsapi.h)

  • Article

[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
ERROR_ACCESS_DENIED
 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.
ERROR_DATABASE_FAILURE
 La base de données est inaccessible ou endommagée.
ERROR_INVALID_HANDLE
 Le handle de session est manquant ou n’est pas valide.
ERROR_INVALID_PARAMETER
 L’identificateur de demande de bibliothèque est manquant.
ERROR_OBJECT_NOT_FOUND
 Impossible de trouver un objet de requête avec l’identificateur spécifié.
ERROR_SUCCESS
 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

Voir aussi

Fonctions de contrôle de bibliothèque

SetNtmsRequestOrder