Função de retorno de chamada FormatProperties
A função de exportação FormatProperties formata os dados exibidos no painel de detalhes da interface do usuário do Monitor de Rede. Se você quiser exibir dados no painel de detalhes, deverá implementar a função de exportação FormatProperties em todas as DLLs do analisador.
Sintaxe
DWORD FormatProperties(
_In_ HFRAME hFrame,
_In_ LPBYTE lpFrame,
_In_ LPBYTE lpProtocol,
_In_ DWORD nPropertyInsts,
_In_ LPPROPERTYINST lpPropInst
);
Parâmetros
-
hFrame [in]
-
Manipule para o quadro que está sendo analisado.
-
lpFrame [in]
-
Ponteiro para o primeiro byte de um quadro.
-
lpProtocol [in]
-
Ponteiro para o início dos dados de protocolo em um quadro.
-
nPropertyInsts [in]
-
Número de estruturas PROPERTYINST fornecidas por lpPropInst.
-
lpPropInst [in]
-
Ponteiro para uma matriz de estruturas PROPERTYINST .
Valor retornado
Se a função for bem-sucedida, o valor retornado será TRUE.
Se a função não for bem-sucedida, o valor retornado será FALSE.
Comentários
O Monitor de Rede chama a função FormatProperties para exibir dados no painel de detalhes da interface do usuário do Monitor de Rede. Normalmente, FormatProperties é chamado para formatar a linha de resumo de um protocolo e formatar todas as instâncias de propriedade do protocolo dentro de um quadro. No entanto, o Monitor de Rede não garante o número de vezes que chama FormatProperties para um analisador específico.
Durante a implementação da função FormatProperties , o analisador chama indiretamente a função FormatPropertyInstance para usar o formatador genérico fornecido pelo Monitor de Rede ou pode chamar um procedimento de formatador personalizado definido pelo analisador. Um dos formatadores deve ser chamado para cada estrutura PROPERTYINST passada para a DLL do analisador no parâmetro lpPropInst .
| Para obter informações sobre | Consulte |
|---|---|
| O que são analisadores e como eles funcionam com o Monitor de Rede. | Analisadores |
| Quais pontos de entrada estão incluídos na DLL do analisador. | Arquitetura de DLL do analisador |
| Como implementar FormatProperties inclui um exemplo. | Implementando FormatProperties |
| Como o formatador genérico formata diferentes tipos de dados. | Saída de formatador genérico |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|