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

Requirement	Value
Header	Atalkwsh.h