Configurare la funzione di callback

Articolo
06/13/2023

La funzione Configure configura l'esperto all'interno della DLL expert.

L'esperto deve implementare la funzione Configure. Quando viene ricevuta la chiamata di funzione, l'esperto visualizza una finestra di dialogo che consente all'utente di modificare qualsiasi elemento configurabile.

Sintassi

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

Parametri

hExpertKey [in]

Identificatore univoco dell'esperto.

L'identificatore univoco viene passato a tutte le funzioni di Monitoraggio di rete specifiche dell'esperto. Tenere presente che l'identificatore potrebbe non essere la stessa chiave dell'esperto di quella passata alla funzione Run . Non archiviare la chiave dell'esperto dalla chiamata Configura .

ppConfig [in, out]

Puntatore a un puntatore a una struttura EXPERTCONFIG all'ingresso.

Dopo l'uscita, la struttura EXPERTCONFIG a cui si fa riferimento contiene i nuovi dati di configurazione.

pExpertStartupInfo [in]

Puntatore all'elemento capture con stato attivo all'avvio dell'esperto.

StartupFlags [in]

Flag che indicano come l'esperto deve usare il parametro pExpertStartupInfo . L'unico flag definito è EXPERT_STARTUP_FLAG_USE_STARTUP_DATA_OVER_CONFIG_DATA. Il flag indica che l'esperto userà il parametro pExpertStartupInfo anziché il parametro ppConfig passato. In genere, si imposta il flag quando si avvia l'esperto da un menu di scelta rapida.

hWnd [in]

Handle per la finestra padre. Usare l'handle per aprire una finestra di dialogo.

Valore restituito

Se la funzione ha esito positivo, ovvero se esiste una configurazione corrente, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE.

Commenti

Monitoraggio di rete chiama la funzione Configure con la configurazione corrente dell'esperto, se presente. L'esperto visualizza una finestra di dialogo con cui è possibile modificare qualsiasi elemento configurabile.

Quando ppConfig viene passato e Monitoraggio di rete non dispone di una configurazione archiviata per l'esperto specificato, il valore del parametro può essere NULL. In questo caso, la funzione Configure presuppone valori predefiniti hardcoded (o usa le informazioni di avvio) per aprire la finestra di dialogo.

I dati di configurazione possono anche essere NULL quando viene restituita la funzione Configure e viene passato un valore NULL . Questa situazione si verifica quando Monitoraggio di rete non ha un valore predefinito archiviato e l'utente preme Annulla.

L'inizio della struttura di dati EXPERTCONFIG include una sezione Private che archivia le informazioni sulle dimensioni della struttura. Le dimensioni della struttura EXPERTCONFIG devono includere la lunghezza DWORD riservata visualizzata all'inizio della struttura. Ad esempio, se i dati di configurazione richiedono 20 byte di spazio di archiviazione, allocare 24 byte per archiviare i dati. Se ppConfig è NULL, la funzione Configure chiama la funzione ExpertAllocMemory per allocare una nuova configurazione con le dimensioni corrette. Se il buffer non è sufficiente per contenere i dati dell'esperto, l'esperto deve chiamare la funzione ExpertReallocMemory .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Netmon.h

Condividi tramite