166 lines
7.1 KiB
C
166 lines
7.1 KiB
C
|
//
|
||
|
|
// 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 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__
|
||
|
|
|