DeleteNtmsRequests, fonction (ntmsapi.h)

Article
02/29/2024

[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

Partager via