Funzione callback AttachProperties

Articolo
06/13/2023

La funzione di esportazione AttachProperties esegue il mapping delle proprietà a una posizione all'interno di una parte di dati riconosciuti. AttachProperties deve essere implementato per ogni parser supportato dalla DLL del parser.

Sintassi

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
);

Parametri

hFrame [in]

Handle del frame analizzato.

lpFrame [in]

Puntatore al primo byte in una cornice.

lpProtocol [in]

Puntatore all'inizio dei dati riconosciuti.

MacType [in]

Valore MAC del primo protocollo in un frame. MacType può essere uno dei seguenti:

Valore	Significato
MAC_TYPE_ETHERNET	802.3
MAC_TYPE_TOKENRING	802.5
MAC_TYPE_FDDI	ANSI X3T9.5

ByteLeft [in]

Numero rimanente di byte in un frame a partire dall'inizio dei dati riconosciuti.

hPreviousProtocol [in]

Handle del protocollo precedente.

nPreviousProtocolOffset [in]

Offset del protocollo precedente a partire dall'inizio del frame.

lpInstData [in]

Puntatore ai dati dell'istanza forniti dal protocollo precedente. I dati dell'istanza non possono essere più lunghi di un DWORD_PTR di lunghezza.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un puntatore al primo byte dopo i dati riconosciuti in un frame o NULL se i dati riconosciuti sono l'ultima parte di dati in un frame.

Se la funzione ha esito negativo, il valore restituito è un puntatore ai dati riconosciuti. Il parametro lpProtocol passa il puntatore alla DLL del parser.

Commenti

Monitoraggio di rete chiama la funzione AttachProperties per ogni parser che riconosce una parte di dati in un frame. Si noti che il parser determina quali proprietà esistono nei dati riconosciuti e dove si trova ogni proprietà.

Durante l'implementazione di AttachProperties, chiamare AttachPropertyInstance per usare i dati in quanto presenti nell'acquisizione. È anche possibile chiamare la funzione AttachPropertyInstanceEx per modificare i dati delle proprietà. Tuttavia, è consigliabile usare i dati in quanto presenti nell'acquisizione.

Le funzioni AttachPropertyInstanceEx e AttachPropertyInstance vengono chiamate solo per le proprietà esistenti nei dati riconosciuti. Si noti che Monitoraggio di rete dispone di un database di proprietà per il parser che contiene una descrizione di tutte le proprietà supportate dal parser.

Dati dell'istanza

I dati dell'istanza sono informazioni passate da un parser a un altro. I dati dell'istanza possono essere dati minori o uguali a un DWORD_PTR di lunghezza o un puntatore ai dati, ad esempio i dati del frame non elaborati, che non devono essere allocati da o liberati dal parser. Nel parametro lpInstData delle funzioni AttachProperties e RecognizeFrame , Monitoraggio di rete fornisce un puntatore ai dati dell'istanza del protocollo precedente. È possibile impostare i dati dell'istanza per il parser durante l'implementazione di RecognizeFrame.

Per informazioni su	Vedere
Quali parser sono e come funzionano con Monitoraggio rete.	Parser
Quali punti di ingresso sono inclusi nella DLL del parser.	Architettura dll del parser
Come riconoscere i dati.	Implementazione di RecognizeFrame
Come creare un database di proprietà.	Implementazione del registro
Come implementare AttachProperties include un esempio.	Implementazione di AttachProperties

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Netmon.h

Vedi anche

AttachPropertyInstance
AttachPropertyInstanceEx
RecognizeFrame