SetNtmsRequestOrder, fonction (ntmsapi.h)

  • Article

[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
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

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

Voir aussi

GetNtmsRequestOrder

Fonctions de contrôle de bibliothèque