NetworkMgr::SetReliableResendCount

Defined in: C4Network.h

Sets the time interval between reliable packet transmission attempts.

Prototype

void SetReliableResendCount(long count);

Parameters

count The number of attempts which are made to transmit a reliable packet.

Description

When the Network Manager sends a reliable packet, it waits for a return receipt, or acknowledgement, from the receiving machine which confirms the packet's arrival at its destination. If an acknowledgement has not been received after a certain time period, the packet is retransmitted. The Network Manager makes a certain number of attempts before a connection is considered to have timed out. The SetReliableResendCount function sets the number of attempts that the Network Manager makes to send a reliable packet.

When a connection times out, the Network Manager calls the currently installed network event procedure, if any, and then disconnects from the machine that timed out. The low-level network event procedure can be set using the NetworkMgr::SetNetworkEventProc function, but this procedure should not be changed if the Message Manager is being used. Instead, the Message Manager will call the Application::HandleConnectionEvent function when a connection times out.