Configuración de la función de devolución de llamada

La función Configure configura el experto en el archivo DLL experto.

El experto debe implementar la función Configure . Cuando se recibe la llamada de función, el experto muestra un cuadro de diálogo que permite al usuario cambiar cualquier elemento configurable.

Sintaxis

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

Parámetros

hExpertKey [in]

Identificador de experto único.

El identificador único se devuelve en todas las funciones de Monitor de red específicas de expertos. Tenga en cuenta que es posible que el identificador no sea la misma clave de experto que la que se pasa a la función Run . No almacene la clave de experto en la llamada Configurar .

ppConfig [in, out]

Puntero a un puntero a una estructura EXPERTCONFIG tras la entrada.

Después de una salida correcta, la estructura EXPERTCONFIG a la que se hace referencia contiene los nuevos datos de configuración.

pExpertStartupInfo [in]

Puntero al elemento de captura con foco cuando se inició el experto.

StartupFlags [in]

Marcas que indican cómo debe usar el experto el parámetro pExpertStartupInfo . La única marca definida es EXPERT_STARTUP_FLAG_USE_STARTUP_DATA_OVER_CONFIG_DATA. La marca indica que el experto usará el parámetro pExpertStartupInfo en lugar del parámetro ppConfig que se pasó. Normalmente, se establece la marca al iniciar el experto desde un menú contextual.

hWnd [in]

Identificador de la ventana primaria. Use el identificador para abrir un cuadro de diálogo.

Valor devuelto

Si la función es correcta (es decir, si existe una configuración actual), el valor devuelto es TRUE.

Si la función no se realiza correctamente, el valor devuelto es FALSE.

Observaciones

Network Monitor llama a la función Configure con la configuración actual del experto, si existe. El experto muestra un cuadro de diálogo, con el que puede cambiar cualquier elemento configurable.

Cuando se pasa ppConfig y Network Monitor no tiene una configuración almacenada para el experto especificado, el valor del parámetro puede ser NULL. En este caso, la función Configure supone valores predeterminados codificados de forma rígida (o, usa la información de inicio) para abrir el cuadro de diálogo.

Los datos de configuración también pueden ser NULL cuando la función Configure devuelve y se pasó un valor NULL . Esta situación se produce cuando Network Monitor no tiene un valor predeterminado almacenado y el usuario presiona Cancelar.

El principio de la estructura de datos EXPERTCONFIG incluye una sección Privada que almacena la información de tamaño de la estructura. El tamaño de la estructura EXPERTCONFIG debe incluir la longitud DWORD reservada que aparece al principio de la estructura. Por ejemplo, si los datos de configuración requieren 20 bytes de espacio de almacenamiento, asigne 24 bytes para almacenar los datos. Si un ppConfig es NULL, la función Configure llama a la función ExpertAllocMemory para asignar una nueva configuración que sea el tamaño correcto. Si el búfer no es suficiente para contener los datos de expertos, el experto debe llamar a la función ExpertReallocMemory .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Netmon.h