SOL_APPLETALK Socket Options

The following table describes SOL_APPLETALK socket options that apply to sockets created for the AppleTalk address family (AF_APPLETALK). See the getsockopt and setsockopt function reference pages for more information on getting and setting socket options.

To enumerate protocols and discover supported properties for each installed protocol, use the WSAEnumProtocols, WSCEnumProtocols, or WSCEnumProtocols32 function.

**SOL\_APPLETALK Socket Options**
Option Get Set Optval type Description
SO_CONFIRM_NAME yes WSH_NBP_TUPLE Confirms that a given AppleTalk name is bound to the given address.
SO_DEREGISTER_NAME yes WSH_REGISTER_NAME Deregisters the name from the network.
SO_GETLOCALZONES yes WSH_LOOKUP_ZONES Returns a list of zone names known to the given adapter name.
SO_GETMYZONE yes char [] Returns the default zone on the network.
SO_GETNETINFO yes WSH_LOOKUP_NETDEF_ON_ADAPTER Returns the seeded values for the network as well as the default zone. The optlen parameter must be at least one byte larger than the size of the WSH_LOOKUP_NETDEF_ON_ADAPTER structure.
SO_GETZONELIST yes WSH_LOOKUP_ZONES Returns zone names from the Internet zone list. The optlen parameter must be at least one byte larger than the size of the WSH_LOOKUP_ZONES structure.
SO_LOOKUP_MYZONE yes Same as SO_GETMYZONE
SO_LOOKUP_NAME yes WSH_LOOKUP_NAME Looks up a specified NBP name and returns the matching tuples of name and NBP information. The optlen parameter must be at least one byte larger than the size of the WSH_LOOKUP_NAME structure.
SO_LOOKUP_NETDEF_ON_ADAPTER yes WSH_LOOKUP_NETDEF_ON_ADAPTER Same as SO_GETNETINFO.
SO_LOOKUP_ZONES yes WSH_LOOKUP_ZONES Same as SO_GETZONELIST.
SO_LOOKUP_ZONES_ON_ADAPTER yes WSH_LOOKUP_ZONES Same as SO_GETLOCALZONES.
SO_PAP_GET_SERVER_STATUS yes WSH_PAP_GET_SERVER_STATUS Returns the PAP status from a given server
SO_PAP_PRIME_READ yes char [] This call primes a read on a PAP connection so the sender can start sending the data
SO_PAP_SET_SERVER_STATUS yes char [] Sets the status to be sent if another client requests the status
SO_REGISTER_NAME yes WSH_REGISTER_NAME Registers the given name on the AppleTalk network
SO_REMOVE_NAME yes WSH_REGISTER_NAME Same as SO_DEREGISTER_NAME

 

**Windows Support for SOL\_APPLETALK options**
Option Windows Vista and later Windows Server 2003 Windows XP Windows 2000 Windows NT4 Windows 9x/Me
SO_CONFIRM_NAME x x x x
SO_DEREGISTER_NAME x x x x
SO_GETLOCALZONES x x x x
SO_GETMYZONE x x x x
SO_GETNETINFO x x x x
SO_GETZONELIST x x x x
SO_LOOKUP_MYZONE x x x x
SO_LOOKUP_NAME x x x x
SO_LOOKUP_NETDEF_ON_ADAPTER x x x x
SO_LOOKUP_ZONES x x x x
SO_LOOKUP_ZONES_ON_ADAPTER x x x x
SO_PAP_GET_SERVER_STATUS x x x x
SO_PAP_PRIME_READ x x x x
SO_PAP_SET_SERVER_STATUS x x x x
SO_REGISTER_NAME x x x x
SO_REMOVE_NAME x x x x

 

The SOL_APPLETALK options are only supported on the server versions of Windows 2000 and Windows NT 4.0.

Remarks

The SOL_APPLETALK socket options and the structures used by these socket options are defined in the Atalkwsh.h header file.

Requirements

Header
Atalkwsh.h