Konfigurieren der Rückruffunktion
Die Configure-Funktion konfiguriert den Experten innerhalb der Experten-DLL.
Der Experte muss die Configure-Funktion implementieren. Wenn der Funktionsaufruf empfangen wird, zeigt der Experte ein Dialogfeld an, in dem der Benutzer jedes konfigurierbare Element ändern kann.
Syntax
BOOL WINAPI Configure(
_In_ HEXPERTKEY hExpertKey,
_Inout_ PEXPERTCONFIG *ppConfig,
_In_ PEXPERTSTARTUPINFO pExpertStartupInfo,
_In_ DWORD StartupFlags,
_In_ HWND hWnd
);
Parameter
-
hExpertKey [ In]
-
Eindeutiger Expertenbezeichner.
Der eindeutige Bezeichner wird an alle expertenspezifischen Netzwerkmonitor Funktionen übergeben. Beachten Sie, dass der Bezeichner möglicherweise nicht mit dem Expertenschlüssel identisch ist, der an die Run-Funktion übergeben wird. Speichern Sie nicht den Expertenschlüssel aus dem Configure-Aufruf.
-
ppConfig [ in, out]
-
Ein Zeiger auf einen Zeiger auf eine EXPERTCONFIG-Struktur beim Eintrag.
Nach einem erfolgreichen Beenden enthält die referenzierte EXPERTCONFIG-Struktur die neuen Konfigurationsdaten.
-
pExpertStartupInfo [ In]
-
Ein Zeiger auf das Erfassungselement mit Fokus, als der Experte gestartet wurde.
-
StartupFlags [ In]
-
Die Flags, die angeben, wie der Experte den pExpertStartupInfo-Parameter verwenden soll. Das einzige definierte Flag ist EXPERT STARTUP FLAG USE STARTUP DATA OVER _ _ _ _ _ _ _ CONFIG _ DATA. Das Flag gibt an, dass der Experte den pExpertStartupInfo-Parameter anstelle des übergebenen ppConfig-Parameters verwendet. In der Regel legen Sie das Flag fest, wenn Sie den Experten über ein Kontextmenü starten.
-
hWnd [ In]
-
Ein Handle für das übergeordnete Fenster. Verwenden Sie das Handle, um ein Dialogfeld zu öffnen.
Rückgabewert
Wenn die Funktion erfolgreich ist (d. h. wenn eine aktuelle Konfiguration vorhanden ist), ist der Rückgabewert TRUE.
Wenn die Funktion nicht erfolgreich ist, lautet der Rückgabewert FALSE.
Hinweise
Netzwerkmonitor ruft die Configure-Funktion mit der aktuellen Konfiguration des Experten auf, sofern vorhanden. Der Experte zeigt ein Dialogfeld an, in dem Sie jedes konfigurierbare Element ändern können.
Wenn ppConfig übergeben wird und Netzwerkmonitor keine Konfiguration für den angegebenen Experten gespeichert hat, kann der Parameterwert NULL sein. In diesem Fall geht die Configure-Funktion von hart codierten Standardwerten aus (oder verwendet die Startinformationen), um das Dialogfeld zu öffnen.
Die Konfigurationsdaten können auch NULL sein, wenn die Configure-Funktion zurückgegeben wird und ein NULL-Wert übergeben wurde. Diese Situation tritt auf, wenn Netzwerkmonitor keinen gespeicherten Standardwert hat und der Benutzer auf Abbrechen drückt.
Der Anfang der EXPERTCONFIG-Datenstruktur enthält einen Privaten -Abschnitt, in dem die Strukturgrößeninformationen gespeichert werden. Die Größe der EXPERTCONFIG-Struktur sollte die reservierte DWORD-Länge enthalten, die am Anfang der Struktur angezeigt wird. Wenn Ihre Konfigurationsdaten beispielsweise 20 Bytes Speicherplatz benötigen, ordnen Sie 24 Bytes zu, um die Daten zu speichern. Wenn ppConfig NULL ist, ruft die Configure-Funktion die ExpertAllocMemory-Funktion auf, um eine neue Konfiguration zuzuordnen, die die richtige Größe aufweist. Wenn der Puffer nicht ausreicht, um die Expertendaten zu speichern, sollte der Experte die ExpertReallocMemory-Funktion aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|