1 files changed, 451 insertions, 0 deletions

diff --git a/private/inc/wsahelp.h b/private/inc/wsahelp.h
new file mode 100644
index 000000000..ff66b786b
--- /dev/null
+++ b/private/inc/wsahelp.h
@@ -0,0 +1,451 @@
+/*++
+
+Copyright (c) 1992 Microsoft Corporation
+
+Module Name:
+
+    WsaHelp.h
+
+Abstract:
+
+    This header file contains prototypes required for Windows Sockets
+    Helper DLLs.  The helper DLLs allow the Windows Sockets DLL to be
+    transport independent by suppling the necessary option get/set and
+    address conversion routines for an individual transport or transport
+    family.
+
+Author:
+
+    David Treadwell (davidtr)    15-Jul-1992
+
+Revision History:
+
+    Keith Moore (keithmo)        08-Jan-1996
+        Added WinSock 2 entrypoints.
+
+--*/
+
+#ifndef _WSAHELP_H_
+#define _WSAHELP_H_
+
+//
+// Notification event definitions.  A helper DLL returns a mask of the
+// events for which it wishes to be notified, and the Windows Sockets
+// DLL calls the helper DLL in WSHNotify for each requested event.
+//
+
+#define WSH_NOTIFY_BIND                 0x01
+#define WSH_NOTIFY_LISTEN               0x02
+#define WSH_NOTIFY_CONNECT              0x04
+#define WSH_NOTIFY_ACCEPT               0x08
+#define WSH_NOTIFY_SHUTDOWN_RECEIVE     0x10
+#define WSH_NOTIFY_SHUTDOWN_SEND        0x20
+#define WSH_NOTIFY_SHUTDOWN_ALL         0x40
+#define WSH_NOTIFY_CLOSE                0x80
+#define WSH_NOTIFY_CONNECT_ERROR        0x100
+
+//
+// Definitions for various internal socket options.  These are used
+// by the Windows Sockets DLL to communicate information to the helper
+// DLL via get and set socket information calls.
+//
+
+#define SOL_INTERNAL 0xFFFE
+#define SO_CONTEXT 1
+
+//
+// Open, Notify, and Socket Option routine prototypes.
+//
+
+typedef
+INT
+(WINAPI * PWSH_OPEN_SOCKET) (
+    IN PINT AddressFamily,
+    IN PINT SocketType,
+    IN PINT Protocol,
+    OUT PUNICODE_STRING TransportDeviceName,
+    OUT PVOID *HelperDllSocketContext,
+    OUT PDWORD NotificationEvents
+    );
+
+INT
+WINAPI
+WSHOpenSocket (
+    IN OUT PINT AddressFamily,
+    IN OUT PINT SocketType,
+    IN OUT PINT Protocol,
+    OUT PUNICODE_STRING TransportDeviceName,
+    OUT PVOID *HelperDllSocketContext,
+    OUT PDWORD NotificationEvents
+    );
+
+typedef
+INT
+(WINAPI * PWSH_NOTIFY) (
+    IN PVOID HelperDllSocketContext,
+    IN SOCKET SocketHandle,
+    IN HANDLE TdiAddressObjectHandle,
+    IN HANDLE TdiConnectionObjectHandle,
+    IN DWORD NotifyEvent
+    );
+
+INT
+WINAPI
+WSHNotify (
+    IN PVOID HelperDllSocketContext,
+    IN SOCKET SocketHandle,
+    IN HANDLE TdiAddressObjectHandle,
+    IN HANDLE TdiConnectionObjectHandle,
+    IN DWORD NotifyEvent
+    );
+
+typedef
+INT
+(WINAPI * PWSH_GET_SOCKET_INFORMATION) (
+    IN PVOID HelperDllSocketContext,
+    IN SOCKET SocketHandle,
+    IN HANDLE TdiAddressObjectHandle,
+    IN HANDLE TdiConnectionObjectHandle,
+    IN INT Level,
+    IN INT OptionName,
+    OUT PCHAR OptionValue,
+    OUT PINT OptionLength
+    );
+
+INT
+WINAPI
+WSHGetSocketInformation (
+    IN PVOID HelperDllSocketContext,
+    IN SOCKET SocketHandle,
+    IN HANDLE TdiAddressObjectHandle,
+    IN HANDLE TdiConnectionObjectHandle,
+    IN INT Level,
+    IN INT OptionName,
+    OUT PCHAR OptionValue,
+    OUT PINT OptionLength
+    );
+
+typedef
+INT
+(WINAPI * PWSH_SET_SOCKET_INFORMATION) (
+    IN PVOID HelperDllSocketContext,
+    IN SOCKET SocketHandle,
+    IN HANDLE TdiAddressObjectHandle,
+    IN HANDLE TdiConnectionObjectHandle,
+    IN INT Level,
+    IN INT OptionName,
+    IN PCHAR OptionValue,
+    IN INT OptionLength
+    );
+
+INT
+WINAPI
+WSHSetSocketInformation (
+    IN PVOID HelperDllSocketContext,
+    IN SOCKET SocketHandle,
+    IN HANDLE TdiAddressObjectHandle,
+    IN HANDLE TdiConnectionObjectHandle,
+    IN INT Level,
+    IN INT OptionName,
+    IN PCHAR OptionValue,
+    IN INT OptionLength
+    );
+
+//
+// Structure and routine for determining the address family/socket
+// type/protocol triples supported by an individual Windows Sockets
+// Helper DLL.  The Rows field of WINSOCK_MAPPING determines the
+// number of entries in the Mapping[] array; the Columns field is
+// always 3 for Windows/NT product 1.
+//
+
+typedef struct _WINSOCK_MAPPING {
+    DWORD Rows;
+    DWORD Columns;
+    struct {
+        DWORD AddressFamily;
+        DWORD SocketType;
+        DWORD Protocol;
+    } Mapping[1];
+} WINSOCK_MAPPING, *PWINSOCK_MAPPING;
+
+typedef
+DWORD
+(WINAPI * PWSH_GET_WINSOCK_MAPPING) (
+    OUT PWINSOCK_MAPPING Mapping,
+    IN DWORD MappingLength
+    );
+
+DWORD
+WINAPI
+WSHGetWinsockMapping (
+    OUT PWINSOCK_MAPPING Mapping,
+    IN DWORD MappingLength
+    );
+
+//
+// Address manipulation routine.
+//
+
+typedef enum _SOCKADDR_ADDRESS_INFO {
+    SockaddrAddressInfoNormal,
+    SockaddrAddressInfoWildcard,
+    SockaddrAddressInfoBroadcast,
+    SockaddrAddressInfoLoopback
+} SOCKADDR_ADDRESS_INFO, *PSOCKADDR_ADDRESS_INFO;
+
+typedef enum _SOCKADDR_ENDPOINT_INFO {
+    SockaddrEndpointInfoNormal,
+    SockaddrEndpointInfoWildcard,
+    SockaddrEndpointInfoReserved
+} SOCKADDR_ENDPOINT_INFO, *PSOCKADDR_ENDPOINT_INFO;
+
+typedef struct _SOCKADDR_INFO {
+    SOCKADDR_ADDRESS_INFO AddressInfo;
+    SOCKADDR_ENDPOINT_INFO EndpointInfo;
+} SOCKADDR_INFO, *PSOCKADDR_INFO;
+
+typedef
+INT
+(WINAPI * PWSH_GET_SOCKADDR_TYPE) (
+    IN PSOCKADDR Sockaddr,
+    IN DWORD SockaddrLength,
+    OUT PSOCKADDR_INFO SockaddrInfo
+    );
+
+INT
+WINAPI
+WSHGetSockaddrType (
+    IN PSOCKADDR Sockaddr,
+    IN DWORD SockaddrLength,
+    OUT PSOCKADDR_INFO SockaddrInfo
+    );
+
+typedef
+INT
+(WINAPI * PWSH_GET_WILDCARD_SOCKADDR) (
+    IN PVOID HelperDllSocketContext,
+    OUT PSOCKADDR Sockaddr,
+    OUT PINT SockaddrLength
+    );
+
+INT
+WINAPI
+WSHGetWildcardSockaddr (
+    IN PVOID HelperDllSocketContext,
+    OUT PSOCKADDR Sockaddr,
+    OUT PINT SockaddrLength
+    );
+
+typedef
+INT
+(WINAPI * PWSH_ENUM_PROTOCOLS) (
+    IN LPINT lpiProtocols,
+    IN LPTSTR lpTransportKeyName,
+    IN OUT LPVOID lpProtocolBuffer,
+    IN OUT LPDWORD lpdwBufferLength
+    );
+
+INT
+WINAPI
+WSHEnumProtocols (
+    IN LPINT lpiProtocols,
+    IN LPTSTR lpTransportKeyName,
+    IN OUT LPVOID lpProtocolBuffer,
+    IN OUT LPDWORD lpdwBufferLength
+    );
+
+#ifdef _WINSOCK2API_
+
+//
+// New WinSock 2 Entrypoints.
+//
+
+typedef
+INT
+(WINAPI * PWSH_OPEN_SOCKET2) (
+    IN PINT AddressFamily,
+    IN PINT SocketType,
+    IN PINT Protocol,
+    IN GROUP Group,
+    IN DWORD Flags,
+    OUT PUNICODE_STRING TransportDeviceName,
+    OUT PVOID *HelperDllSocketContext,
+    OUT PDWORD NotificationEvents
+    );
+
+INT
+WINAPI
+WSHOpenSocket2 (
+    IN OUT PINT AddressFamily,
+    IN OUT PINT SocketType,
+    IN OUT PINT Protocol,
+    IN GROUP Group,
+    IN DWORD Flags,
+    OUT PUNICODE_STRING TransportDeviceName,
+    OUT PVOID *HelperDllSocketContext,
+    OUT PDWORD NotificationEvents
+    );
+
+typedef
+INT
+(WINAPI * PWSH_JOIN_LEAF) (
+    IN PVOID HelperDllSocketContext,
+    IN SOCKET SocketHandle,
+    IN HANDLE TdiAddressObjectHandle,
+    IN HANDLE TdiConnectionObjectHandle,
+    IN PVOID LeafHelperDllSocketContext,
+    IN SOCKET LeafSocketHandle,
+    IN PSOCKADDR Sockaddr,
+    IN DWORD SockaddrLength,
+    IN LPWSABUF CallerData,
+    IN LPWSABUF CalleeData,
+    IN LPQOS SocketQOS,
+    IN LPQOS GroupQOS,
+    IN DWORD Flags
+    );
+
+INT
+WINAPI
+WSHJoinLeaf (
+    IN PVOID HelperDllSocketContext,
+    IN SOCKET SocketHandle,
+    IN HANDLE TdiAddressObjectHandle,
+    IN HANDLE TdiConnectionObjectHandle,
+    IN PVOID LeafHelperDllSocketContext,
+    IN SOCKET LeafSocketHandle,
+    IN PSOCKADDR Sockaddr,
+    IN DWORD SockaddrLength,
+    IN LPWSABUF CallerData,
+    IN LPWSABUF CalleeData,
+    IN LPQOS SocketQOS,
+    IN LPQOS GroupQOS,
+    IN DWORD Flags
+    );
+
+INT
+WINAPI
+WSHAddressToString (
+    IN LPSOCKADDR Address,
+    IN INT AddressLength,
+    IN LPWSAPROTOCOL_INFOW ProtocolInfo,
+    OUT LPWSTR AddressString,
+    IN OUT LPDWORD AddressStringLength
+    );
+
+typedef
+INT
+(WINAPI * PWSH_ADDRESS_TO_STRING) (
+    IN LPSOCKADDR Address,
+    IN INT AddressLength,
+    IN LPWSAPROTOCOL_INFOW ProtocolInfo,
+    OUT LPWSTR AddressString,
+    IN OUT LPDWORD AddressStringLength
+    );
+
+INT
+WINAPI
+WSHStringToAddress (
+    IN LPWSTR AddressString,
+    IN DWORD AddressFamily,
+    IN LPWSAPROTOCOL_INFOW ProtocolInfo,
+    OUT LPSOCKADDR Address,
+    IN OUT LPINT AddressLength
+    );
+
+typedef
+INT
+(WINAPI * PWSH_STRING_TO_ADDRESS) (
+    IN LPWSTR AddressString,
+    IN DWORD AddressFamily,
+    IN LPWSAPROTOCOL_INFOW ProtocolInfo,
+    OUT LPSOCKADDR Address,
+    IN OUT LPINT AddressLength
+    );
+
+typedef
+INT
+(WINAPI * PWSH_GET_BROADCAST_SOCKADDR) (
+    IN PVOID HelperDllSocketContext,
+    OUT PSOCKADDR Sockaddr,
+    OUT PINT SockaddrLength
+    );
+
+INT
+WINAPI
+WSHGetBroadcastSockaddr (
+    IN PVOID HelperDllSocketContext,
+    OUT PSOCKADDR Sockaddr,
+    OUT PINT SockaddrLength
+    );
+
+typedef
+INT
+(WINAPI * PWSH_GET_PROVIDER_GUID) (
+    IN LPWSTR ProviderName,
+    OUT LPGUID ProviderGuid
+    );
+
+INT
+WINAPI
+WSHGetProviderGuid (
+    IN LPWSTR ProviderName,
+    OUT LPGUID ProviderGuid
+    );
+
+typedef
+INT
+(WINAPI * PWSH_GET_WSAPROTOCOL_INFO) (
+    IN LPWSTR ProviderName,
+    OUT LPWSAPROTOCOL_INFOW * ProtocolInfo,
+    OUT LPDWORD ProtocolInfoEntries
+    );
+
+INT
+WINAPI
+WSHGetWSAProtocolInfo (
+    IN LPWSTR ProviderName,
+    OUT LPWSAPROTOCOL_INFOW * ProtocolInfo,
+    OUT LPDWORD ProtocolInfoEntries
+    );
+
+typedef
+INT
+(WINAPI * PWSH_IOCTL) (
+    IN PVOID HelperDllSocketContext,
+    IN SOCKET SocketHandle,
+    IN HANDLE TdiAddressObjectHandle,
+    IN HANDLE TdiConnectionObjectHandle,
+    IN DWORD IoControlCode,
+    IN LPVOID InputBuffer,
+    IN DWORD InputBufferLength,
+    IN LPVOID OutputBuffer,
+    IN DWORD OutputBufferLength,
+    OUT LPDWORD NumberOfBytesReturned,
+    IN LPWSAOVERLAPPED Overlapped,
+    IN LPWSAOVERLAPPED_COMPLETION_ROUTINE CompletionRoutine,
+    OUT LPBOOL NeedsCompletion
+    );
+
+INT
+WINAPI
+WSHIoctl (
+    IN PVOID HelperDllSocketContext,
+    IN SOCKET SocketHandle,
+    IN HANDLE TdiAddressObjectHandle,
+    IN HANDLE TdiConnectionObjectHandle,
+    IN DWORD IoControlCode,
+    IN LPVOID InputBuffer,
+    IN DWORD InputBufferLength,
+    IN LPVOID OutputBuffer,
+    IN DWORD OutputBufferLength,
+    OUT LPDWORD NumberOfBytesReturned,
+    IN LPWSAOVERLAPPED Overlapped,
+    IN LPWSAOVERLAPPED_COMPLETION_ROUTINE CompletionRoutine,
+    OUT LPBOOL NeedsCompletion
+    );
+
+#endif  // _WINSOCK2API_
+
+#endif  // _WSAHELP_H_
+