Méthode IDsAdminNotifyHandler::Begin (dsadmin.h)

Article
08/23/2023

La méthode IDsAdminNotifyHandler::Begin est appelée lorsqu’un événement demandé par le gestionnaire de notifications se produit. Le gestionnaire de notifications spécifie les événements pour ant recevoir des notifications lorsque IDsAdminNotifyHandler::Initialize est appelé.

Syntaxe

HRESULT Begin(
  [in]  ULONG       uEvent,
  [in]  IDataObject *pArg1,
  [in]  IDataObject *pArg2,
  [out] ULONG       *puFlags,
  [out] BSTR        *pBstr
);

Paramètres

[in] uEvent

Contient une valeur qui spécifie le type d’événement qui se produit. Il peut s’agir de l’une des valeurs suivantes.

DSA_NOTIFY_DEL

Un objet est supprimé.

DSA_NOTIFY_REN

Un objet est renommé.

DSA_NOTIFY_MOV

Un objet est déplacé vers un autre conteneur.

DSA_NOTIFY_PROP

Une ou plusieurs propriétés d’un objet sont modifiées.

[in] pArg1

Pointeur vers une interface IDataObject qui prend en charge le format CFSTR_DSOBJECTNAMES Presse-papiers. Le contenu de l’objet de données varie en fonction de la valeur de uEvent. Pour plus d'informations, consultez la section Notes.

[in] pArg2

Pointeur vers une interface IDataObject qui prend en charge le format CFSTR_DSOBJECTNAMES Presse-papiers. La valeur de ce paramètre et le contenu de l’objet de données varient en fonction de la valeur de uEvent. Pour plus d'informations, consultez la section Notes.

[out] puFlags

Pointeur vers une valeur ULONG qui reçoit un ensemble d’indicateurs qui modifient le comportement du gestionnaire de notifications dans la boîte de dialogue de confirmation de notification. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs suivantes.

DSA_NOTIFY_FLAG_ADDITIONAL_DATA

Si cet indicateur est défini, l’entrée de ce gestionnaire de notifications dans la boîte de dialogue de confirmation est sélectionnée. Si cet indicateur n’est pas défini, l’entrée de ce gestionnaire de notifications dans la boîte de dialogue de confirmation n’est pas sélectionnée.

DSA_NOTIFY_FLAG_FORCE_ADDITIONAL_DATA

Si cet indicateur est défini, l’entrée de ce gestionnaire de notifications dans la boîte de dialogue de confirmation est désactivée et l’utilisateur ne peut pas modifier l’état de sélection.

[out] pBstr

Pointeur vers un BSTR qui reçoit une chaîne qui contient le nom et/ou la description du gestionnaire de notification. Cette chaîne s’affiche dans la boîte de dialogue de confirmation. Cette chaîne doit être allouée en appelant la fonction SysAllocString . L’appelant doit libérer cette chaîne lorsqu’elle n’est plus nécessaire. Si ce paramètre reçoit null ou une chaîne vide, le gestionnaire de notification n’est pas ajouté à la boîte de dialogue de confirmation et IDsAdminNotifyHandler::Notify n’est pas appelé.

Valeur retournée

Si la méthode réussit, S_OK est retourné. Si la méthode échoue, une valeur HRESULT standard est retournée.

Notes

La valeur et le contenu de pArg1 et pArg2 varient en fonction de l’événement traité comme indiqué par uEvent. La liste suivante explique ce que pArg1 et pArg2 contiennent pour chaque type d’événement différent.

uEvent	pArg1	pArg2
DSA_NOTIFY_DEL	Contient l’objet supprimé.	Non utilisé. Cette valeur sera NULL.
DSA_NOTIFY_REN	Contient le nom précédent de l’objet.	Contient le nouveau nom de l’objet.
DSA_NOTIFY_MOV	Contient le conteneur à partir duquel l’objet est déplacé.	Contient le conteneur vers lequel l’objet est déplacé.
DSA_NOTIFY_PROP	Contient l’objet pour lequel les propriétés ont été modifiées.	Non utilisé. Cette valeur sera NULL.

Spécifications


Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	dsadmin.h
DLL	DSAdmin.dll