Previous

Next

Function xn_lcp_want_magic

Sets the magic number to negotiate.

int xn_lcp_want_magic(int   iface_no, 
                      DWORD local_seed, 
                      DWORD remote_seed);

Parameters

iface_no

Interface number returned by xn_attach.

local_seed

Seed to use for the random number generator for calculating the magic number when sending Configuration-Requests.

remote_seed

Seed to use for the random number generator for calculating magic number when sending naks when loop-back link is detected.

return value

Returns 0 if successful, otherwise SOCKET_ERROR. If an error occurred, call xn_getlasterror and xn_geterror_string to return the error value. Section Error Codes further describes each error.

Possible values for this function are:

This function establishes that the LCP Magic-Number option should be requested and assigns the values to use as seeds.

Call this function with local_seed set to a non-zero value to request the Magic-Number option. The option will be requested in the Configuration-Request message sent to the remote host and will be accepted in requests from the remote host. local_seed is the seed for the random number generator to use when sending Configuration Requests. remote_seed is the seed for the random number generator to use when sending Configuration NAKS. The requested option will be dropped if it is rejected by the remote host. If the request is rejected, the interface is not in a loopback state. If local_seed is set to 0, the option will not be requested.

Call this function with local_seed set to 0 to accept the option requested by the remote host (but not to request the option). The seeds are not used in this scenario.

The default value is to not request this option.

PPP

Function xn_lcp_want_chap

Function xn_lcp_want_mru