Función de devolución de llamada FormatProperties
La función de exportación FormatProperties da formato a los datos que se muestran en el panel de detalles de la interfaz de usuario de Network Monitor. Si desea mostrar datos en el panel de detalles, debe implementar la función de exportación FormatProperties en todos los archivos DLL del analizador.
Sintaxis
DWORD FormatProperties(
_In_ HFRAME hFrame,
_In_ LPBYTE lpFrame,
_In_ LPBYTE lpProtocol,
_In_ DWORD nPropertyInsts,
_In_ LPPROPERTYINST lpPropInst
);
Parámetros
-
hFrame [in]
-
Controle el marco que se está a analizar.
-
lpFrame [in]
-
Puntero al primer byte de un marco.
-
lpProtocol [in]
-
Puntero al principio de los datos del protocolo en un marco.
-
nPropertyInsts [in]
-
Número de estructuras PROPERTYINST proporcionadas por lpPropInst.
-
lpPropInst [in]
-
Puntero a una matriz de estructuras PROPERTYINST .
Valor devuelto
Si la función se ejecuta correctamente, 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 FormatProperties para mostrar datos en el panel de detalles de la interfaz de usuario de Network Monitor. Normalmente, se llama a FormatProperties para dar formato a la línea de resumen de un protocolo y, a continuación, para dar formato a todas las instancias de propiedad del protocolo dentro de un marco. Sin embargo, Network Monitor no garantiza el número de veces que llama a FormatProperties para un analizador específico.
Durante la implementación de la función FormatProperties , el analizador llama indirectamente a la función FormatPropertyInstance para usar el formateador genérico que proporciona Network Monitor o puede llamar a un procedimiento de formateador personalizado definido por el analizador. Se debe llamar a uno de los formateadores para cada estructura PROPERTYINST que se pasa al archivo DLL del analizador en el parámetro lpPropInst .
| Para obtener información sobre | Vea |
|---|---|
| Qué son los analizadores y cómo funcionan con Network Monitor. | Analizadores |
| Qué puntos de entrada se incluyen en el archivo DLL del analizador. | Arquitectura dll del analizador |
| Cómo implementar FormatProperties incluye un ejemplo. | Implementación de FormatProperties |
| Cómo el formateador genérico da formato a diferentes tipos de datos. | Salida de formateador genérico |
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 |
|