Função de retorno de chamada AttachProperties
A função de exportação AttachProperties mapeia as propriedades para um local dentro de um pedaço de dados reconhecidos. AttachProperties deve ser implementado para cada analisador compatível com a DLL do analisador.
Sintaxe
DWORD AttachProperties(
_In_ HFRAME hFrame,
_In_ LPBYTE lpFrame,
_In_ LPBYTE lpProtocol,
_In_ DWORD MacType,
_In_ DWORD BytesLeft,
_In_ HPROTOCOL hPreviousProtocol,
_In_ DWORD nPreviousProtocolOffset,
_In_ DWORD lpInstData
);
Parâmetros
-
hFrame [in]
-
Identificador do quadro que está sendo analisado.
-
lpFrame [in]
-
Ponteiro para o primeiro byte em um quadro.
-
lpProtocol [in]
-
Ponteiro para o início dos dados reconhecidos.
-
MacType [in]
-
Valor MAC do primeiro protocolo em um quadro. O MacType pode ser um dos seguintes:
Valor Significado - MAC_TYPE_ETHERNET
802.3 - MAC_TYPE_TOKENRING
802.5 - MAC_TYPE_FDDI
ANSI X3T9.5 -
BytesLeft [in]
-
O número restante de bytes em um quadro começando no início dos dados reconhecidos.
-
hPreviousProtocol [in]
-
Identificador do protocolo anterior.
-
nPreviousProtocolOffset [in]
-
Deslocamento do protocolo anterior começando no início do quadro.
-
lpInstData [in]
-
Ponteiro para os dados de instância fornecidos pelo protocolo anterior. Os dados de instância não podem ter mais tempo do que um DWORD_PTR de comprimento.
Valor retornado
Se a função for bem-sucedida, o valor retornado será um ponteiro para o primeiro byte após os dados reconhecidos em um quadro ou NULL se os dados reconhecidos forem a última parte dos dados em um quadro.
Se a função não for bem-sucedida, o valor retornado será um ponteiro para os dados reconhecidos. O parâmetro lpProtocol passa o ponteiro para a DLL do analisador.
Comentários
O Monitor de Rede chama a função AttachProperties para cada analisador que reconhece um pedaço de dados em um quadro. Observe que o analisador determina quais propriedades existem nos dados reconhecidos e onde cada propriedade está localizada.
Durante a implementação de AttachProperties, chame AttachPropertyInstance para usar os dados como eles existem na captura. Você também pode chamar a função AttachPropertyInstanceEx para modificar os dados da propriedade. No entanto, é recomendável que você use os dados como eles existem na captura.
As funções AttachPropertyInstanceEx e AttachPropertyInstance são chamadas apenas para as propriedades que existem nos dados reconhecidos. Observe que o Monitor de Rede tem um banco de dados de propriedade para o analisador que contém uma descrição de todas as propriedades compatíveis com o analisador.
Dados de instância
Dados de instância são informações passadas de um analisador para outro. Os dados de instância podem ser dados menores ou iguais a um DWORD_PTR de comprimento ou um ponteiro para dados, como dados brutos de quadro, que não precisam ser alocados ou liberados pelo analisador. No parâmetro lpInstData das funções AttachProperties e RecognizeFrame , o Monitor de Rede fornece um ponteiro para os dados da instância do protocolo anterior. Você pode definir os dados da instância para o analisador durante a implementação do RecognizeFrame.
| 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 reconhecer dados. | Implementando RecognizeFrame |
| Como criar um banco de dados de propriedades. | Implementando o registro |
| Como implementar AttachProperties inclui um exemplo. | Implementando AttachProperties |
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 |
|