//
// NetConn.h
//
//		Header file for APIs exported by NConn32.dll
//
// History:
//
//		 3/12/1999  KenSh     Created
//		 9/29/1999  KenSh     Changed JetNet stuff to NetConn for HNW
//

#ifndef __NETCONN_H__
#define __NETCONN_H__



// Callback procedure - return TRUE to continue, FALSE to abort
typedef BOOL (CALLBACK FAR* PROGRESS_CALLBACK)(LPVOID pvParam, DWORD dwCurrent, DWORD dwTotal);


// NetConn return values
//
#define FACILITY_NETCONN 0x0177
#define NETCONN_SUCCESS				MAKE_HRESULT(SEVERITY_SUCCESS, FACILITY_NETCONN, 0x0000)
#define NETCONN_NEED_RESTART		MAKE_HRESULT(SEVERITY_SUCCESS, FACILITY_NETCONN, 0x0001)
#define NETCONN_ALREADY_INSTALLED	MAKE_HRESULT(SEVERITY_SUCCESS, FACILITY_NETCONN, 0x0002)
#define NETCONN_NIC_INSTALLED		MAKE_HRESULT(SEVERITY_SUCCESS, FACILITY_NETCONN, 0x0003)
#define NETCONN_NIC_INSTALLED_OTHER	MAKE_HRESULT(SEVERITY_SUCCESS, FACILITY_NETCONN, 0x0004)
#define NETCONN_UNKNOWN_ERROR		MAKE_HRESULT(SEVERITY_ERROR,   FACILITY_NETCONN, 0x0000)
#define NETCONN_USER_ABORT			MAKE_HRESULT(SEVERITY_ERROR,   FACILITY_NETCONN, 0x0001)
#define NETCONN_PROTOCOL_NOT_FOUND	MAKE_HRESULT(SEVERITY_ERROR,   FACILITY_NETCONN, 0x0002)
#define NETCONN_NOT_IMPLEMENTED		MAKE_HRESULT(SEVERITY_ERROR,   FACILITY_NETCONN, 0x0003)
#define NETCONN_WRONG_PLATFORM		MAKE_HRESULT(SEVERITY_ERROR,   FACILITY_NETCONN, 0x0004)
#define NETCONN_MISSING_DLL			MAKE_HRESULT(SEVERITY_ERROR,   FACILITY_NETCONN, 0x0005)
#define NETCONN_OS_NOT_SUPPORTED	MAKE_HRESULT(SEVERITY_ERROR,   FACILITY_NETCONN, 0x0006)
#define NETCONN_INVALID_ARGUMENT	MAKE_HRESULT(SEVERITY_ERROR,   FACILITY_NETCONN, 0x0007)

#define SZ_CLASS_ADAPTER	L"Net"
#define SZ_CLASS_CLIENT		L"NetClient"
#define SZ_CLASS_PROTOCOL	L"NetTrans"
#define SZ_CLASS_SERVICE	L"NetService"

#define SZ_PROTOCOL_TCPIP	L"MSTCP"
#define SZ_PROTOCOL_NETBEUI	L"NETBEUI"
#define SZ_PROTOCOL_IPXSPX	L"NWLINK"

#define SZ_SERVICE_VSERVER	L"VSERVER"
#define SZ_CLIENT_MICROSOFT	L"VREDIR"
#define SZ_CLIENT_NETWARE	L"NWREDIR"

#define NIC_UNKNOWN			0x00
#define NIC_VIRTUAL			0x01
#define NIC_ISA				0x02
#define NIC_PCI				0x03
#define NIC_PCMCIA			0x04
#define NIC_USB				0x05
#define NIC_PARALLEL		0x06
#define NIC_MF      		0x07
#define NIC_1394			0x08	// NDIS 1394 Net Adapter

#define NETTYPE_LAN			0x00	// a network card
#define NETTYPE_DIALUP		0x01	// a Dial-Up Networking adapter
#define NETTYPE_IRDA		0x02	// an IrDA connection
#define NETTYPE_PPTP		0x03	// a virtual private networking adapter for PPTP
#define NETTYPE_TV          0x04    // a TV adapter
#define NETTYPE_ISDN        0x05    // ISDN adapter

#define SUBTYPE_NONE		0x00	// nothing special
#define SUBTYPE_ICS			0x01	// ICS adapter (NIC_VIRTUAL, NETTYPE_LAN)
#define SUBTYPE_AOL			0x02	// AOL adapter (NIC_VIRTUAL, NETTYPE_LAN)
#define SUBTYPE_VPN			0x03	// VPN support (NETTYPE_DIALUP)

#define ICS_NONE			0x00	// NIC has no connection to ICS
#define ICS_EXTERNAL		0x01	// NIC is ICS's external adapter
#define ICS_INTERNAL		0x02	// NIC is ICS's internal adapter

#define NICERR_NONE			0x00	// no error
#define NICERR_MISSING		0x01	// device is in registry but not physically present
#define NICERR_DISABLED		0x02	// device exists but has been disabled (red X in devmgr)
#define NICERR_BANGED		0x03	// device has a problem (yellow ! in devmgr)
#define NICERR_CORRUPT		0x04	// NIC has class key but no enum key

#define NICWARN_NONE		0x00	// no warning
#define NICWARN_WARNING		0x01	// yellow ! in devmgr, otherwise everything looks ok


#include <pshpack1.h>

typedef struct tagNETADAPTER {
	WCHAR szDisplayName[260];		// so-called friendly name of adapter
	WCHAR szDeviceID[260];			// e.g. "PCI\VEN_10b7&DEV_9050"
	WCHAR szEnumKey[260];			// e.g. "Enum\PCI\VEN_10b7&DEV_9050&SUBSYS_00000000&REV_00\407000"
	WCHAR szClassKey[40];			// PnP-assigned class name + ID, e.g. "Net\0000"
	WCHAR szManufacturer[60];		// Company that manufactured the card, e.g. "3Com"
	WCHAR szInfFileName[50];			// File title of INF file, e.g. "NETEL90X.INF"
	BYTE  bNicType;					// a NIC_xxx constant, defined above
	BYTE  bNetType;					// a NETTYPE_xxx constant, defined above
	BYTE  bNetSubType;				// a SUBTYPE_xxx constant, defined above
	BYTE  bIcsStatus;				// an ICS_xxx constant, defined above
	BYTE  bError;					// a NICERR_xxx constant, defined above
	BYTE  bWarning;					// a NICWARN_xxx constant, defined above
	DWORD devnode;                  // configmg device node
} NETADAPTER;

typedef struct tagNETSERVICE {
	WCHAR szDisplayName[260];		// (supposedly) friendly name of service
	WCHAR szDeviceID[260];			// e.g. "VSERVER"
	WCHAR szClassKey[40];			// PnP-assigned class name + ID, e.g. "NetService\0000"
} NETSERVICE;

#include <poppack.h>

#ifdef __cplusplus
extern "C" {
#endif

// NCONN32.DLL exported functions
//
//  NOTE: if you change anything here, change NConn32.cpp also!!
//
LPVOID  WINAPI NetConnAlloc(DWORD cbAlloc);
VOID    WINAPI NetConnFree(LPVOID pMem);
BOOL    WINAPI IsProtocolInstalled(LPCWSTR pszProtocolDeviceID, BOOL bExhaustive);
HRESULT WINAPI InstallProtocol(LPCWSTR pszProtocol, HWND hwndParent, PROGRESS_CALLBACK pfnCallback, LPVOID pvCallbackParam);
HRESULT WINAPI InstallTCPIP(HWND hwndParent, PROGRESS_CALLBACK pfnProgress, LPVOID pvProgressParam);
HRESULT WINAPI RemoveProtocol(LPCWSTR pszProtocol);
BOOL    WINAPI IsMSClientInstalled(BOOL bExhaustive);
HRESULT WINAPI InstallMSClient(HWND hwndParent, PROGRESS_CALLBACK pfnProgress, LPVOID pvProgressParam);
HRESULT WINAPI EnableBrowseMaster();
BOOL    WINAPI IsSharingInstalled(BOOL bExhaustive);
BOOL    WINAPI IsFileSharingEnabled();
BOOL    WINAPI IsPrinterSharingEnabled();
HRESULT WINAPI InstallSharing(HWND hwndParent, PROGRESS_CALLBACK pfnProgress, LPVOID pvProgressParam);
BOOL    WINAPI FindConflictingService(LPCWSTR pszWantService, NETSERVICE* pConflict);
HRESULT WINAPI EnableSharingAppropriately();
int     WINAPI EnumNetAdapters(NETADAPTER FAR** pprgNetAdapters);
HRESULT WINAPI InstallNetAdapter(LPCWSTR pszDeviceID, LPCWSTR pszInfPath, HWND hwndParent, PROGRESS_CALLBACK pfnProgress, LPVOID pvCallbackParam);
BOOL    WINAPI IsAccessControlUserLevel();
HRESULT WINAPI DisableUserLevelAccessControl();
HRESULT WINAPI EnableQuickLogon();
BOOL    WINAPI IsProtocolBoundToAdapter(LPCWSTR pszProtocolID, const NETADAPTER* pAdapter);
HRESULT WINAPI EnableNetAdapter(const NETADAPTER* pAdapter);
BOOL    WINAPI IsClientInstalled(LPCWSTR pszClient, BOOL bExhaustive);
HRESULT WINAPI RemoveClient(LPCWSTR pszClient);
HRESULT WINAPI RemoveGhostedAdapters(LPCWSTR pszDeviceID);
HRESULT WINAPI RemoveUnknownAdapters(LPCWSTR pszDeviceID);
BOOL    WINAPI DoesAdapterMatchDeviceID(const NETADAPTER* pAdapter, LPCWSTR pszDeviceID);
BOOL    WINAPI IsAdapterBroadband(const NETADAPTER* pAdapter);
void    WINAPI SaveBroadbandSettings(LPCWSTR pszBroadbandAdapterNumber);
BOOL    WINAPI UpdateBroadbandSettings(LPWSTR pszEnumKeyBuf, int cchEnumKeyBuf);
HRESULT WINAPI DetectHardware(LPCWSTR pszDeviceID);
int     WINAPI EnumMatchingNetBindings(LPCWSTR pszParentBinding, LPCWSTR pszDeviceID, LPWSTR** pprgBindings);
HRESULT WINAPI RestartNetAdapter(DWORD devnode);
HRESULT WINAPI HrFromLastWin32Error();
HRESULT WINAPI HrWideCharToMultiByte( const WCHAR* szwString, char** ppszString );
HRESULT WINAPI HrEnableDhcp( VOID* pContext, DWORD dwFlags );
BOOLEAN WINAPI IsAdapterDisconnected( VOID* pContext );
HRESULT WINAPI IcsUninstall(void);


#ifdef __cplusplus
}
#endif

#endif // !__NETCONN_H__