Packet Sniffer SDK VCL Edition

HNFileAdapter :: Methods :: SyncSendEx

Write packet to CAP file synchronously.

Syntax:

function SyncSendEx(HANDLE hPacket) : DWORD;

Parameters:

hPacket

[in] HNPacket object handle.

Return values:

HNERR_OK	The packet has been written successfully.
HNERR_ADAPTER_NOT_OPENED	The CAP file has not been opened, see the HNFileAdapter.CreateFile function.
HNERR_ADDR_ERR	hPacket has the wrong value (a memory write error).
HNERR_INCOMPATIBLE_MODE	Incompatible mode of HNFileAdapter. Occurs when HNFileAdapter.AutoMode was set, or if the CAP file was opened for data writing (see HNFileAdapter.CreateFile function).
HNERR_WRITE_FILE	File write error.

Description:

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

Example of writing packets to CAP file with SyncSendEx:

// Create HNPacket object
HNPacket1 := HNPacket.Create(); 
HNPacket1.Handle := HNPacket1.AllocatePacket(1514);

pPacketData = HNPacket1.PacketData; 
// Write data to the packet buffer
...

// Create CAP file
Res = HNFileAdapter1.CreateFile("packets.cap");
...

// Write packet to file
Res = HNFileAdapter1.SyncSendEx(HNPacket1.Handle);