Funzione callback AttachProperties
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 |
|