Méthode IDsAdminNotifyHandler::Begin (dsadmin.h)
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 |