DeleteNtmsRequests, fonction (ntmsapi.h)

  • Article

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

La fonction DeleteNtmsRequests supprime une demande ou une liste de requêtes de la base de données RSM. Les demandes de bibliothèque ou d’opérateur qui se trouvent dans un état terminé, ayant échoué, refusé ou annulé sont supprimées. Les demandes envoyées, les demandes en file d’attente, les demandes en attente et les demandes en cours ne peuvent pas être supprimées.

Syntaxe

DWORD DeleteNtmsRequests(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwType,
  [in] DWORD       dwCount
);

Paramètres

[in] hSession

Gérez la session retournée par la fonction OpenNtmsSession .

[in] lpRequestId

Liste des identificateurs de la bibliothèque et des demandes d’opérateur à supprimer.

[in] dwType

Type de la demande. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
NTMS_LIBREQUEST
 Demande de bibliothèque.
NTMS_OPREQUEST
 Demande d’opérateur.

[in] dwCount

Nombre de demandes dans la liste.

Valeur retournée

Cette fonction retourne l’une des valeurs suivantes.

Valeur Signification
ERROR_ACCESS_DENIED
 NTMS_MODIFY_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 : 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é.
ERROR_DATABASE_FAILURE
 La base de données est inaccessible ou endommagée.
ERROR_DATABASE_FULL
 La base de données est pleine.
ERROR_INVALID_PARAMETER
 L’identificateur de type n’est pas valide.
ERROR_INVALID_HANDLE
 Le handle de session est manquant ou n’est pas valide.
ERROR_NOT_ENOUGH_MEMORY
 Échec d’allocation de mémoire pendant le traitement.
ERROR_SUCCESS
 La fonction s’est exécutée avec succès.

Remarques

Une erreur n’est pas retournée si une demande ou une liste de requêtes est introuvable.

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