OpenNtmsNotification, fonction (ntmsapi.h)

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

La fonction OpenNtmsNotification ouvre un canal pour recevoir des notifications de modification d’objet RSM pour les objets du type spécifié.

Syntaxe

HANDLE OpenNtmsNotification(
  [in] HANDLE hSession,
  [in] DWORD  dwType
);

Paramètres

[in] hSession

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

[in] dwType

Type d’objet RSM pour la notification. Pour obtenir la liste des valeurs, consultez NtmsObjectsTypes.

Valeur retournée

La fonction OpenNtmsNotification retourne un handle de notification que vous passez aux fonctions WaitForNtmsNotification ou CloseNtmsNotification .

Pour obtenir des informations d’erreur étendues, appelez la fonction GetLastError . Cette fonction peut retourner l’une des valeurs suivantes.

Valeur Signification
ERROR_ACCESS_DENIED
NTMS_USE_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
Échec de la requête ou de la mise à jour de la base de données.
ERROR_INVALID_HANDLE
La valeur spécifiée dans le paramètre hSession est NULL ou n’est pas valide.
ERROR_NOT_CONNECTED
Impossible de se connecter au service RSM.
ERROR_SUCCESS
La fonction a réussi.
INVALID_HANDLE_VALUE
Échec de la fonction.

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

CloseNtmsNotification

Fonctions de notification de base de données

WaitForNtmsNotification