CancelNtmsLibraryRequest, fonction (ntmsapi.h)

Article
03/06/2024

[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

Partager via