Konfigurieren der Rückruffunktion
Die Funktion Configure 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.
BOOL WINAPI Configure(
_In_ HEXPERTKEY hExpertKey,
_Inout_ PEXPERTCONFIG *ppConfig,
_In_ PEXPERTSTARTUPINFO pExpertStartupInfo,
_In_ DWORD StartupFlags,
_In_ HWND hWnd
);
-
hExpertKey [in]
-
Eindeutiger Expertenbezeichner.
Der eindeutige Bezeichner wird für alle expertenspezifischen Netzwerkmonitorfunktionen zurückgegeben. Beachten Sie, dass der Bezeichner möglicherweise nicht derselbe Expertenschlüssel ist wie der, der an die Run-Funktion übergeben wird. Speichern Sie den Expertenschlüssel aus dem Configure-Aufruf nicht.
-
ppConfig [in, out]
-
Ein Zeiger auf einen Zeiger auf eine EXPERTCONFIG-Struktur bei der Eingabe.
Nach einem erfolgreichen Beenden enthält die referenzierte EXPERTCONFIG-Struktur die neuen Konfigurationsdaten.
-
pExpertStartupInfo [in]
-
Ein Zeiger auf das Erfassungselement mit Fokus, wenn 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.
Wenn die Funktion erfolgreich ist (d. h. wenn eine aktuelle Konfiguration vorhanden ist), ist der Rückgabewert TRUE.
Wenn die Funktion nicht erfolgreich ist, ist der Rückgabewert FALSE.
Der Netzwerkmonitor ruft die Configure-Funktion mit der aktuellen Konfiguration des Experten auf, sofern vorhanden. Der Experte zeigt ein Dialogfeld an, mit dem Sie jedes konfigurierbare Element ändern können.
Wenn ppConfig übergeben wird und für den Netzwerkmonitor keine Konfiguration für den angegebenen Experten gespeichert ist, kann der Parameterwert NULL sein. In diesem Fall geht die Configure-Funktion von hartcodierten 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 der Netzwerkmonitor keine gespeicherte Standardeinstellung aufweist und der Benutzer abbrechen drückt.
Der Anfang der EXPERTCONFIG-Datenstruktur enthält einen Privaten Abschnitt, in dem die Informationen zur Strukturgröße 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 Byte Speicherplatz erfordern, weisen Sie 24 Bytes zum Speichern der Daten zu. Wenn eine ppConfigNULL ist, ruft die Configure-Funktion die Funktion ExpertAllocMemory auf, um eine neue Konfiguration mit der richtigen Größe zuzuordnen. Wenn der Puffer nicht ausreicht, um die Expertendaten zu enthalten, sollte der Experte die ExpertReallocMemory-Funktion aufrufen.
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
Header |
|