IDA_FindServers

 

int IDA_FindServers(idaServID_t *servIDList, uint servIdArrayCnt,

ulong multicast_in_addr, ushort multicast_in_port,

uint multicast_ttl, uint multicast_retries,

ulong multicast_noresponse_timeout,

ulong multicast_overall_timeout);

 

Parameters

servIDList

[out] Pointer to the buffer to contain the retrieved list of servers. A pointer to an array of SERVER_IDENTIFIERstructures.

servIdArrayCnt

[in] Specifies the maximum number of server structures that the users buffer can hold. I.e., the number of idaServID_t slots available in the servIDList buffer.

multicast_in_addr

[in] The multicast address. Specify 0 to use the default multicast address of 224.46.90.81.

multicast_in_port

[in]The multicast port.Specify 0 to use the default port of 6088.

multicast_ttl

[in] The multicast Time-To-Live. Specify 0 to use the system default.

multicast_retries

[in] Number of retries. Specify 0 to use the default of 1.

multicast_noresponse_timeout

[in] Response timeout (millisecs).Specify zero to use default of 5 seconds.

multicast_overall_timeout

[in] The multicast address. Specify 0 to use the default multicast address of 224.46.90.81.

multicast_in_addr

[in]The complete timeout period. This may be used to specify a maximum time you wish to wait for a response. Specify zero to use the default of 0 seconds. 0 seconds for overall says to return after waiting for multicast_noresponse_timeout.

 

Return Value

Non-negative value indicates the number of SERVER_IDENTIFIERstructures populated. (The number of InSight servers responding).

Negative return code will contain the actual tcpip error status.

Remarks

This method is used to retrieve a list of all InSight servers available on the network.

This method sends a multicast message onto the network and returns a list of all servers that respond.