Configurer la fonction de rappel

Article
06/13/2023

La fonction Configurer configure l’expert dans la DLL d’expert.

L’expert doit implémenter la fonction Configurer . Lorsque l’appel de fonction est reçu, l’expert affiche une boîte de dialogue qui permet à l’utilisateur de modifier n’importe quel élément configurable.

Syntaxe

BOOL WINAPI Configure(
  _In_    HEXPERTKEY         hExpertKey,
  _Inout_ PEXPERTCONFIG      *ppConfig,
  _In_    PEXPERTSTARTUPINFO pExpertStartupInfo,
  _In_    DWORD              StartupFlags,
  _In_    HWND               hWnd
);

Paramètres

hExpertKey [in]

Identificateur d’expert unique.

L’identificateur unique est renvoyé à toutes les fonctions de moniteur réseau spécifiques à un expert. N’oubliez pas que l’identificateur peut ne pas être la même clé d’expert que celle passée à la fonction Exécuter . Ne stockez pas la clé d’expert de l’appel Configurer .

ppConfig [in, out]

Pointeur vers un pointeur vers une structure EXPERTCONFIG lors de l’entrée.

Après une sortie réussie, la structure EXPERTCONFIG référencée contient les nouvelles données de configuration.

pExpertStartupInfo [in]

Pointeur vers l’élément de capture avec focus au démarrage de l’expert.

StartupFlags [in]

Indicateurs qui indiquent comment l’expert doit utiliser le paramètre pExpertStartupInfo . Le seul indicateur défini est EXPERT_STARTUP_FLAG_USE_STARTUP_DATA_OVER_CONFIG_DATA. L’indicateur indique que l’expert utilisera le paramètre pExpertStartupInfo plutôt que le paramètre ppConfig transmis. En règle générale, vous définissez l’indicateur lorsque vous démarrez l’expert à partir d’un menu contextuel.

hWnd [in]

Handle de la fenêtre parente. Utilisez le handle pour ouvrir une boîte de dialogue.

Valeur retournée

Si la fonction réussit (autrement dit, si une configuration actuelle existe), la valeur de retour est TRUE.

Si la fonction échoue, la valeur de retour est FALSE.

Notes

Le Moniteur réseau appelle la fonction Configurer avec la configuration actuelle de l’expert, le cas échéant. L’expert affiche une boîte de dialogue avec laquelle vous pouvez modifier n’importe quel élément configurable.

Lorsque ppConfig est transmis et que network Monitor n’a pas de configuration stockée pour l’expert spécifié, la valeur du paramètre peut être NULL. Dans ce cas, la fonction Configurer suppose des valeurs par défaut codées en dur (ou utilise les informations de démarrage) pour ouvrir la boîte de dialogue.

Les données de configuration peuvent également être NULL lorsque la fonction Configurer retourne et qu’une valeur NULL a été transmise. Cette situation se produit lorsque le Moniteur réseau n’a pas de valeur par défaut stockée et que l’utilisateur appuie sur Annuler.

Le début de la structure de données EXPERTCONFIG comprend une section Privée qui stocke les informations de taille de structure. La taille de la structure EXPERTCONFIG doit inclure la longueur DWORD réservée qui apparaît au début de la structure. Par exemple, si vos données de configuration nécessitent 20 octets d’espace de stockage, allouez 24 octets pour stocker les données. Si un ppConfig a la valeur NULL, la fonction Configurer appelle la fonction ExpertAllocMemory pour allouer une nouvelle configuration qui correspond à la taille appropriée. Si la mémoire tampon n’est pas suffisante pour contenir les données d’expert, l’expert doit appeler la fonction ExpertReallocMemory .

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Netmon.h