// // 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 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 #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__