418 lines
10 KiB
C
418 lines
10 KiB
C
|
/******************************************************************************
|
||
|
|
**
|
||
|
|
** Copyright (c) 1998-1999 Microsoft Corporation
|
||
|
|
**
|
||
|
|
** Module Name:
|
||
|
|
**
|
||
|
|
** icsapi.h
|
||
|
|
**
|
||
|
|
** Abstract:
|
||
|
|
**
|
||
|
|
** External header for Internet Connection Sharing API module
|
||
|
|
**
|
||
|
|
** Author:
|
||
|
|
**
|
||
|
|
** Bruce Johnson (bjohnson)
|
||
|
|
**
|
||
|
|
**
|
||
|
|
** Environment:
|
||
|
|
**
|
||
|
|
** Win32.
|
||
|
|
**
|
||
|
|
** Revision History:
|
||
|
|
**
|
||
|
|
** Date Author Comments
|
||
|
|
** -------- ---------- ----------------------------------------------------
|
||
|
|
** 03/08/99 bjohnson Created
|
||
|
|
**
|
||
|
|
****************************************************************************/
|
||
|
|
|
||
|
|
//****************************************************************************
|
||
|
|
// Defines
|
||
|
|
//****************************************************************************
|
||
|
|
|
||
|
|
//
|
||
|
|
// ICSAPI32 parameters
|
||
|
|
//
|
||
|
|
|
||
|
|
|
||
|
|
//****************************************************************************
|
||
|
|
// ICS Return Codes
|
||
|
|
//****************************************************************************
|
||
|
|
|
||
|
|
#define ICS_ERROR_SUCCESS 0x00000000
|
||
|
|
#define ICS_ERROR_FAILURE 0x80000001
|
||
|
|
#define ICS_ERROR_NOT_IMPLEMENTED 0x80000002
|
||
|
|
#define ICS_ERROR_NO_MEMORY 0x80000003
|
||
|
|
#define ICS_ERROR_INVALID_OPTION 0x80000004
|
||
|
|
#define ICS_ERROR_INVALID_PARAMETER 0x80000005
|
||
|
|
|
||
|
|
//****************************************************************************
|
||
|
|
// Options for IcsSetMapping
|
||
|
|
//****************************************************************************
|
||
|
|
#define ICS_PORTMAP_ENABLE 1
|
||
|
|
#define ICS_PORTMAP_DISABLE 2
|
||
|
|
#define ICS_PORTMAP_DISABLE_ALL 3
|
||
|
|
#define ICS_PORTMAP_ENABLE_NON_PERSISTENT 4
|
||
|
|
|
||
|
|
//****************************************************************************
|
||
|
|
// Options for IcsDisconnect
|
||
|
|
//****************************************************************************
|
||
|
|
#define ICS_DISCONNECT_IMMEDIATELY 0
|
||
|
|
#define ICS_DISCONNECT_IF_IDLE 1
|
||
|
|
|
||
|
|
//****************************************************************************
|
||
|
|
// Connect status
|
||
|
|
//****************************************************************************
|
||
|
|
#define ICS_CONN_STATUS_DISCONNECTED 0
|
||
|
|
#define ICS_CONN_STATUS_DIALING 1
|
||
|
|
#define ICS_CONN_STATUS_AUTHENTICATING 2
|
||
|
|
#define ICS_CONN_STATUS_CONNECTED 3
|
||
|
|
#define ICS_CONN_STATUS_LINE_IDLE 4
|
||
|
|
|
||
|
|
//****************************************************************************
|
||
|
|
// Autodial configuration
|
||
|
|
//****************************************************************************
|
||
|
|
#define ICS_AUTODIAL_OPT_NONE 0x00000000 // No options
|
||
|
|
#define ICS_AUTODIAL_OPT_NEVER 0x00000001 // Never Autodial
|
||
|
|
#define ICS_AUTODIAL_OPT_ALWAYS 0x00000002 // Autodial regardless
|
||
|
|
#define ICS_AUTODIAL_OPT_DEMAND 0x00000004 // Autodial on demand
|
||
|
|
|
||
|
|
//****************************************************************************
|
||
|
|
// Ip Information options
|
||
|
|
//****************************************************************************
|
||
|
|
#define ICS_IP_OPT_NONE 0x00000000 // No options
|
||
|
|
#define ICS_IP_OPT_ENABLE_DHCP 0x00000001 // Enable DHCP
|
||
|
|
|
||
|
|
//****************************************************************************
|
||
|
|
// Miscellaneous
|
||
|
|
//****************************************************************************
|
||
|
|
#define ICS_MAX_NAME 255
|
||
|
|
#define ICS_MAX_PORTKEY 255
|
||
|
|
#define ICS_MAX_INDEX 255
|
||
|
|
#define ICS_MAX_STRING 1024
|
||
|
|
#define ICS_DISABLED 0
|
||
|
|
#define ICS_ENABLED 1
|
||
|
|
|
||
|
|
//****************************************************************************
|
||
|
|
// Typedefs
|
||
|
|
//****************************************************************************
|
||
|
|
|
||
|
|
//
|
||
|
|
// ICS Machine Information
|
||
|
|
//
|
||
|
|
|
||
|
|
typedef struct _ICS_MACHINE_INFO {
|
||
|
|
char szName[ICS_MAX_NAME+1];
|
||
|
|
BYTE bMacAddress[6];
|
||
|
|
DWORD IpAddress;
|
||
|
|
DWORD dwLeaseTime;
|
||
|
|
DWORD dwOptions;
|
||
|
|
|
||
|
|
} ICS_MACHINE_INFO, *PICS_MACHINE_INFO, *LPICS_MACHINE_INFO;
|
||
|
|
|
||
|
|
//
|
||
|
|
// ICS Client Options
|
||
|
|
//
|
||
|
|
|
||
|
|
typedef struct _ICS_CLIENT_OPTIONS {
|
||
|
|
char szName[ICS_MAX_NAME+1];
|
||
|
|
DWORD dwOptions;
|
||
|
|
|
||
|
|
} ICS_CLIENT_OPTIONS, *PICS_CLIENT_OPTIONS, *LPICS_CLIENT_OPTIONS;
|
||
|
|
|
||
|
|
//
|
||
|
|
// ICS Port Mapping
|
||
|
|
//
|
||
|
|
|
||
|
|
typedef struct _ICS_PORT_MAPPING {
|
||
|
|
char szName[ICS_MAX_NAME+1];
|
||
|
|
char szPortMapping[ICS_MAX_PORTKEY+1];
|
||
|
|
DWORD dwOptions;
|
||
|
|
|
||
|
|
} ICS_PORT_MAPPING, *PICS_PORT_MAPPING, *LPICS_PORT_MAPPING;
|
||
|
|
|
||
|
|
|
||
|
|
//
|
||
|
|
// ICS Active Port Mapping
|
||
|
|
//
|
||
|
|
|
||
|
|
typedef struct _ICS_ACTIVE_PORT_MAPPING {
|
||
|
|
ICS_PORT_MAPPING PortMap;
|
||
|
|
ICS_MACHINE_INFO Client;
|
||
|
|
|
||
|
|
} ICS_ACTIVE_PORT_MAPPING, *PICS_ACTIVE_PORT_MAPPING, *LPICS_ACTIVE_PORT_MAPPING;
|
||
|
|
|
||
|
|
|
||
|
|
//
|
||
|
|
// ICS Adapter Information
|
||
|
|
//
|
||
|
|
|
||
|
|
typedef struct _ICS_ADAPTER {
|
||
|
|
char szAdapterName[ICS_MAX_NAME+1];
|
||
|
|
char szAdapterIndex[ICS_MAX_INDEX+1];
|
||
|
|
|
||
|
|
} ICS_ADAPTER, *PICS_ADAPTER, *LPICS_ADAPTER;
|
||
|
|
|
||
|
|
|
||
|
|
//
|
||
|
|
// ICS IP Information
|
||
|
|
//
|
||
|
|
|
||
|
|
typedef struct _ICS_IP_INFORMATION {
|
||
|
|
DWORD dwOptions;
|
||
|
|
char szIPAddress[ICS_MAX_STRING];
|
||
|
|
char szIPMask[ICS_MAX_STRING];
|
||
|
|
char szDefaultGateway[ICS_MAX_STRING];
|
||
|
|
char szDNSServerPrimary[ICS_MAX_STRING];
|
||
|
|
char szDNSServerSecondary[ICS_MAX_STRING];
|
||
|
|
char szHostName[ICS_MAX_STRING];
|
||
|
|
char szDomainName[ICS_MAX_STRING];
|
||
|
|
char szDomainSuffixSearchList[ICS_MAX_STRING];
|
||
|
|
} ICS_IP_INFORMATION, *PICS_IP_INFORMATION, *LPICS_IP_INFORMATION;
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
//
|
||
|
|
// ICS General Statistics
|
||
|
|
//
|
||
|
|
|
||
|
|
typedef struct _ICS_GENERAL_STATISTICS {
|
||
|
|
DWORD dwBytesSent;
|
||
|
|
DWORD dwBytesReceived;
|
||
|
|
DWORD dwActiveClients;
|
||
|
|
DWORD dwActivePortMappings;
|
||
|
|
DWORD dwUpTime;
|
||
|
|
DWORD dwStatusFlags;
|
||
|
|
char szAutodialMachine [ICS_MAX_NAME+1];
|
||
|
|
|
||
|
|
} ICS_GENERAL_STATISTICS, *PICS_GENERAL_STATISTICS, *LPICS_GENERAL_STATISTICS;
|
||
|
|
|
||
|
|
//
|
||
|
|
// ICS General Configuration
|
||
|
|
//
|
||
|
|
|
||
|
|
typedef struct _ICS_GENERAL_CONFIGURATION {
|
||
|
|
DWORD dwEnabled;
|
||
|
|
DWORD dwShowTrayIcon;
|
||
|
|
DWORD dwDHCPEnabled;
|
||
|
|
DWORD dwDNSEnabled;
|
||
|
|
DWORD dwLoggingEnabled;
|
||
|
|
DWORD dwDHCPSubnet;
|
||
|
|
DWORD dwDHCPServerAddress;
|
||
|
|
DWORD dwOptions;
|
||
|
|
DWORD dwAutodialEnabled;
|
||
|
|
DWORD dwAutodialTimeout;
|
||
|
|
char szAutodialConnection [ICS_MAX_NAME+1];
|
||
|
|
char szInternetAdapter [ICS_MAX_INDEX+1];
|
||
|
|
char szHomeNetworkAdapter [ICS_MAX_INDEX+1];
|
||
|
|
|
||
|
|
} ICS_GENERAL_CONFIGURATION, *PICS_GENERAL_CONFIGURATION, *LPICS_GENERAL_CONFIGURATION;
|
||
|
|
|
||
|
|
typedef struct _ICS_GENERAL_CONFIGURATION ICS_CONFIG, *PICS_CONFIG, *LPICS_CONFIG;
|
||
|
|
|
||
|
|
|
||
|
|
typedef enum {
|
||
|
|
ICS_MSG_CONNECT_STATUS_CHANGE,
|
||
|
|
ICS_MSG_ICS_STATUS_CHANGE,
|
||
|
|
} ICS_MESSAGE_TYPE;
|
||
|
|
|
||
|
|
typedef struct
|
||
|
|
{
|
||
|
|
DWORD dwConnectStatus;
|
||
|
|
DWORD dwLastError;
|
||
|
|
} ICS_MSG_CONNECT_STATUS_CHANGE_INFO;
|
||
|
|
|
||
|
|
typedef struct
|
||
|
|
{
|
||
|
|
DWORD dwIcsStatus;
|
||
|
|
} ICS_MSG_ICS_STATUS_CHANGE_INFO;
|
||
|
|
|
||
|
|
typedef struct _ICS_MESSAGE {
|
||
|
|
ICS_MESSAGE_TYPE Type;
|
||
|
|
union
|
||
|
|
{
|
||
|
|
ICS_MSG_CONNECT_STATUS_CHANGE_INFO IcsConnectStatusChangeInfo;
|
||
|
|
ICS_MSG_ICS_STATUS_CHANGE_INFO IcsStatusChangeInfo;
|
||
|
|
} MsgSpecific;
|
||
|
|
} ICS_MESSAGE, *LPICS_MESSAGE;
|
||
|
|
|
||
|
|
#define IM_dwConnectStatus MsgSpecific.IcsConnectStatusChangeInfo.dwConnectStatus
|
||
|
|
#define IM_dwLastError MsgSpecific.IcsConnectStatusChangeInfo.dwLastError
|
||
|
|
#define IM_dwIcsStatus MsgSpecific.IcsStatusChangeInfo.dwIcsStatus
|
||
|
|
|
||
|
|
typedef VOID (WINAPI *ICS_MSG_NOTIFIER_FN)(LPICS_MESSAGE pIcsMsg);
|
||
|
|
|
||
|
|
//****************************************************************************
|
||
|
|
//
|
||
|
|
// Prototypes
|
||
|
|
//
|
||
|
|
//****************************************************************************
|
||
|
|
|
||
|
|
|
||
|
|
//****************************************************************************
|
||
|
|
// Configuration API's
|
||
|
|
//****************************************************************************
|
||
|
|
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsGetConfiguration(
|
||
|
|
LPICS_CONFIG lpIcsConfig
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsSetConfiguration(
|
||
|
|
LPICS_CONFIG lpIcsConfig
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsGetAdapterList(
|
||
|
|
LPICS_ADAPTER lpIcsAdapterList,
|
||
|
|
LPDWORD lpdwBufferSize
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsGetIpInformation(
|
||
|
|
LPICS_ADAPTER lpIcsAdapter,
|
||
|
|
LPICS_IP_INFORMATION lpIcsIpInformation
|
||
|
|
);
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsSetIpInformation(
|
||
|
|
LPICS_ADAPTER lpIcsAdapter,
|
||
|
|
LPICS_IP_INFORMATION lpIcsIpInformation
|
||
|
|
);
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsSetInternetConnection(
|
||
|
|
LPICS_ADAPTER lpIcsAdapter
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsSetHomenetConnection(
|
||
|
|
LPICS_ADAPTER lpIcsAdapter
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsEnumerateInstalledMappings(
|
||
|
|
LPICS_PORT_MAPPING lpIcsPortMappings,
|
||
|
|
LPDWORD lpdwBufferSize
|
||
|
|
);
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsGetAutodialEnable(
|
||
|
|
LPDWORD lpdwOpt
|
||
|
|
);
|
||
|
|
|
||
|
|
//****************************************************************************
|
||
|
|
// Management API's
|
||
|
|
//****************************************************************************
|
||
|
|
|
||
|
|
BOOLEAN APIENTRY
|
||
|
|
IsIcsInstalled(
|
||
|
|
VOID
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
BOOLEAN APIENTRY
|
||
|
|
IsIcsAvailable(
|
||
|
|
VOID
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
BOOLEAN APIENTRY
|
||
|
|
IsIcsEnabled(
|
||
|
|
VOID
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsConnect(
|
||
|
|
LPSTR lpszPhonebook,
|
||
|
|
BOOL Synchronous
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsDisconnect(
|
||
|
|
DWORD dwOptions
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsEnable(
|
||
|
|
DWORD dwOptions
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsDisable(
|
||
|
|
DWORD dwOptions
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsGetStatistics(
|
||
|
|
LPICS_GENERAL_STATISTICS lpIcsGeneralStats
|
||
|
|
);
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
Remote_IcsGetStatistics(
|
||
|
|
LPICS_GENERAL_STATISTICS lpIcsGeneralStats
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsEnumerateClients(
|
||
|
|
LPICS_MACHINE_INFO lpIcsClients,
|
||
|
|
LPDWORD lpdwBufferSize
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsEnumerateActiveMappings(
|
||
|
|
LPICS_ACTIVE_PORT_MAPPING lpIcsActiveMappings,
|
||
|
|
LPDWORD lpdwBufferSize
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsSetMapping(
|
||
|
|
LPICS_MACHINE_INFO lpIcsClient,
|
||
|
|
LPICS_PORT_MAPPING lpIcsPortMap,
|
||
|
|
DWORD dwOptions
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsGetClientOptions(
|
||
|
|
LPICS_MACHINE_INFO lpIcsClient,
|
||
|
|
LPICS_CLIENT_OPTIONS lpIcsClientOptions
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsSetClientOptions(
|
||
|
|
LPICS_MACHINE_INFO lpIcsClient,
|
||
|
|
LPICS_CLIENT_OPTIONS lpIcsClientOptions
|
||
|
|
);
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsGetConnectStatus(
|
||
|
|
LPDWORD lpdwConnectStatus,
|
||
|
|
LPDWORD lpdwLastError
|
||
|
|
);
|
||
|
|
|
||
|
|
|
||
|
|
DWORD APIENTRY
|
||
|
|
IcsRegisterNotifierCallback(
|
||
|
|
LPVOID fnNotifier,
|
||
|
|
DWORD Options
|
||
|
|
);
|
||
|
|
|