Packet Sniffer SDK DLL Edition

HNFileAdapter :: Methods :: FAdpSyncSendEx

 Previous Next

Write packet to CAP file synchronously.

Syntax:

DWORD __stdcall FAdpSyncSendEx(HANDLE hFAdp, HANDLE hPkt);

Parameters:

hFAdp

[in] HNFileAdapter object handle.

hPacket

[in] HNPacket object handle.

Return values:

HNERR_OKThe packet has been written successfully.
HNERR_ADAPTER_NOT_OPENEDThe CAP file has not been opened, see the FAdpCreateFile function.
HNERR_ADDR_ERRhPkt has the wrong value (a memory write error).
HNERR_INCOMPATIBLE_MODEIncompatible mode of HNFileAdapter. Occurs when HNFileAdapter.AutoMode was set [Get/Set]), or if the CAP file was opened for data writing (see FAdpCreateFile function).
HNERR_WRITE_FILEFile write error.
HNERR_INVALID_HANDLEhFAdp parameter is not the HNFileAdapter object handle.

Description:

After successful creation of CAP file by FAdpCreateFile function you may dump packets to it by this function synchronously.

Example of writing packets to CAP file with FAdpSyncSendEx:

// Create HNPacket object
HANDLE hPkt = PktCreate(1514); 
LPVOID pPacketData = PktGetPacketData(hPkt); 
// Write data to the packet buffer
...

// Create CAP file
DWORD Res = FAdpCreateFile(hFAdp, "packets.cap");
...

// Write packet to file
Res = FAdpSyncSendEx(hFAdp, hPkt);
See also:HNFileAdapter, FAdpCreateFile, FAdpSyncSend, HNFileAdapter.AutoMode