CancelNtmsLibraryRequest, fonction (ntmsapi.h)

  • Article

[Le Gestionnaire de stockage amovible n’est plus disponible depuis Windows 7 et Windows Server 2008 R2.]

La fonction CancelNtmsLibraryRequest annule les requêtes RSM en attente, telles que les appels à la fonction CleanNtmsDrive . Si la bibliothèque est occupée, RSM met en file d’attente l’annulation et retourne la réussite.

Syntaxe

DWORD CancelNtmsLibraryRequest(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId
);

Paramètres

[in] hSession

Handle à la session retournée par la fonction OpenNtmsSession .

[in] lpRequestId

Identificateur unique de la demande de bibliothèque à annuler.

Pour récupérer la liste des demandes de bibliothèque existantes, utilisez la fonction EnumerateNtmsObject .

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur Signification
ERROR_ACCESS_DENIED
 Seul un administrateur du serveur RSM peut annuler les demandes de bibliothèque. Cette erreur est également retournée si la requête est en cours de traitement et ne peut pas être supprimée.
ERROR_INVALID_HANDLE
 Le handle de session est manquant ou n’est pas valide.
ERROR_NOT_ENOUGH_MEMORY
 Il y a eu un échec d’allocation pendant le traitement.
ERROR_OBJECT_NOT_FOUND
 L’ID d’objet de la demande de bibliothèque est introuvable. Cette erreur se produit si la demande est terminée avant l’émission de l’annulation ou lorsqu’un ID de demande non valide est spécifié.
ERROR_SUCCESS
 La demande de bibliothèque a été mise en file d’attente pour annulation.

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

EnumerateNtmsObject

Fonctions de contrôle de bibliothèque