//--------------------------------------------------------------------------- // // Copyright (c) Microsoft Corporation 1993-1994 // // File: modemui.c // // This files contains the DLL entry-points. // // Much of this file contains the code that builds the default property dialog // for modem devices. // // This code was originally lifted from SETUP4.DLL, which performs essentially // the same thing, except for any device. We don't want to have to link to // SETUP4.DLL, so we contain a copy of this code. // // // History: // 1-12-94 ScottH Created // 9-20-95 ScottH Ported to NT // //--------------------------------------------------------------------------- #include "proj.h" // common headers #include "cfgui.h" DWORD CMI_Load( LPCFGMODEMINFO pcmi, LPCTSTR pszFriendlyName, UMDEVCFG *pDevCfg, HWND hwndParent ); void CMI_UnLoad( LPCFGMODEMINFO pcmi ); DWORD PRIVATE CfgAddGeneralPage( LPCFGMODEMINFO pcmi, LPFNADDPROPSHEETPAGE pfnAdd, LPARAM lParam); BOOL ValidateDevConfig(UMDEVCFG *pDevCfg); DWORD RegQueryModemCaps( HKEY hkeyDrv, MODEMCAPS *pCaps ); MODEM_PROTOCOL_CAPS * GetProtocolCaps( HKEY hkDrv ); LONG GetFriendlyProtocolName( DWORD ProtocolId, LPTSTR FriendlyName, DWORD BufferLength, LPDWORD StringLength ); IDSTR rgidstrISDNCompatibleProtocols[] = { {MDM_PROTOCOL_AUTO_1CH, 0, "AUTO_1CH"}, {MDM_PROTOCOL_AUTO_2CH, 0, "AUTO_2CH"}, {MDM_PROTOCOL_HDLCPPP_56K, 0, "HDLC_PPP_56K"}, {MDM_PROTOCOL_HDLCPPP_64K, 0, "HDLC_PPP_64K"}, {MDM_PROTOCOL_HDLCPPP_112K, 0, "HDLC_PPP_112K"}, {MDM_PROTOCOL_HDLCPPP_112K_PAP, 0, "HDLC_PPP_112K_PAP"}, {MDM_PROTOCOL_HDLCPPP_112K_CHAP, 0, "HDLC_PPP_112K_CHAP"}, {MDM_PROTOCOL_HDLCPPP_112K_MSCHAP, 0, "HDLC_PPP_112K_MSCHAP"}, {MDM_PROTOCOL_HDLCPPP_128K, 0, "HDLC_PPP_128K"}, {MDM_PROTOCOL_HDLCPPP_128K_PAP, 0, "HDLC_PPP_128K_PAP"}, {MDM_PROTOCOL_HDLCPPP_128K_CHAP, 0, "HDLC_PPP_128K_CHAP"}, {MDM_PROTOCOL_HDLCPPP_128K_MSCHAP, 0, "HDLC_PPP_128K_MSCHAP"}, {MDM_PROTOCOL_V120_64K, 0, "V120_64K"}, {MDM_PROTOCOL_V120_56K, 0, "V120_56K"}, {MDM_PROTOCOL_V120_112K, 0, "V120_112K"}, {MDM_PROTOCOL_V120_128K, 0, "V120_128K"}, {MDM_PROTOCOL_X75_64K, 0, "X75_64K"}, {MDM_PROTOCOL_X75_128K, 0, "X75_128K"}, {MDM_PROTOCOL_X75_T_70, 0, "X75_T_70"}, {MDM_PROTOCOL_X75_BTX, 0, "X75_BTX"}, {MDM_PROTOCOL_V110_1DOT2K, 0, "V110_1DOT2K"}, {MDM_PROTOCOL_V110_2DOT4K, 0, "V110_2DOT4K"}, {MDM_PROTOCOL_V110_4DOT8K, 0, "V110_4DOT8K"}, {MDM_PROTOCOL_V110_9DOT6K, 0, "V110_9DOT6K"}, {MDM_PROTOCOL_V110_12DOT0K, 0, "V110_12DOT0K"}, {MDM_PROTOCOL_V110_14DOT4K, 0, "V110_14DOT4K"}, {MDM_PROTOCOL_V110_19DOT2K, 0, "V110_19DOT2K"}, {MDM_PROTOCOL_V110_28DOT8K, 0, "V110_28DOT8K"}, {MDM_PROTOCOL_V110_38DOT4K, 0, "V110_38DOT4K"}, {MDM_PROTOCOL_V110_57DOT6K, 0, "V110_57DOT6K"}, {MDM_PROTOCOL_ANALOG_V34, 0, "ANALOG_V34"}, {MDM_PROTOCOL_PIAFS_INCOMING, 0, "PIAFS_INCOMING"}, {MDM_PROTOCOL_PIAFS_OUTGOING, 0, "PIAFS_OUTGOING"} }; IDSTR rgidstrGSMCompatibleProtocols[] = { {MDM_PROTOCOL_HDLCPPP_56K, 0, "HDLC_PPP_56K"}, {MDM_PROTOCOL_HDLCPPP_64K, 0, "HDLC_PPP_64K"}, {MDM_PROTOCOL_V110_1DOT2K, 0, "V110_1DOT2K"}, {MDM_PROTOCOL_V110_2DOT4K, 0, "V110_2DOT4K"}, {MDM_PROTOCOL_V110_4DOT8K, 0, "V110_4DOT8K"}, {MDM_PROTOCOL_V110_9DOT6K, 0, "V110_9DOT6K"}, {MDM_PROTOCOL_V110_12DOT0K, 0, "V110_12DOT0K"}, {MDM_PROTOCOL_V110_14DOT4K, 0, "V110_14DOT4K"}, {MDM_PROTOCOL_V110_19DOT2K, 0, "V110_19DOT2K"}, {MDM_PROTOCOL_V110_28DOT8K, 0, "V110_28DOT8K"}, {MDM_PROTOCOL_V110_38DOT4K, 0, "V110_38DOT4K"}, {MDM_PROTOCOL_ANALOG_RLP, 0, "ANALOG_RLP"}, {MDM_PROTOCOL_ANALOG_NRLP, 0, "ANALOG_NRLP"}, {MDM_PROTOCOL_GPRS, 0, "GPRS"} }; #define TITLE_LEN 256 #define DEFAULT_LEN 23 /*---------------------------------------------------------- Purpose: Show the properties of a modem Returns: winerror Cond: -- */ DWORD CfgDoProperties( LPCWSTR pszFriendlyName, HWND hwndParent, LPPROPSHEETPAGE pExtPages, // Optional; may be NULL DWORD cExtPages, // Number of external pages UMDEVCFG *pDevCfgIn, UMDEVCFG *pDevCfgOut ) { DWORD dwRet = ERROR_INVALID_PARAMETER; PROPSHEETHEADER psh; HPROPSHEETPAGE hpsPages[MAX_PROP_PAGES]; LPCFGMODEMINFO pcmi = NULL; TCHAR cszConnection[TITLE_LEN]; // Validate params... if ( cExtPages // Unsupported || pDevCfgIn // Unsupported || !ValidateDevConfig(pDevCfgOut)) { MYASSERT(FALSE); goto end; } pcmi = ALLOCATE_MEMORY( sizeof(*pcmi)); if (!pcmi) { // proper error code goto end; } dwRet = CMI_Load( pcmi, pszFriendlyName, pDevCfgOut, hwndParent ); if (dwRet) { goto end; } // Initialize the PropertySheet Header psh.dwSize = sizeof(psh); psh.dwFlags = PSH_NOAPPLYNOW; psh.hwndParent = hwndParent; psh.hInstance = g_hinst; psh.nPages = 0; psh.nStartPage = 0; psh.phpage = (HPROPSHEETPAGE FAR *)hpsPages; psh.pszCaption = cszConnection; lstrcpy (cszConnection, pszFriendlyName); if (lstrlen (cszConnection) < TITLE_LEN-DEFAULT_LEN) { if (FALSE == g_dwIsCalledByCpl) { LoadString( g_hinst, IDS_CONNECTION_PREF, &cszConnection[lstrlen(cszConnection)], TITLE_LEN-lstrlen(cszConnection) ); } else { LoadString( g_hinst, IDS_DEFAULT_PREF, &cszConnection[lstrlen(cszConnection)], TITLE_LEN-lstrlen(cszConnection) ); } } dwRet = CfgAddGeneralPage(pcmi, AddInstallerPropPage, (LPARAM)&psh); if (NO_ERROR == dwRet) { dwRet = AddPage(pcmi, MAKEINTRESOURCE(IDD_CFG_ADVANCED), CfgAdv_WrapperProc, AddInstallerPropPage, (LPARAM)&psh); if (NO_ERROR == dwRet) { // Add extra pages if any if ((cExtPages != 0) && (pExtPages != NULL)) { AddExtraPages(pExtPages, cExtPages, AddInstallerPropPage, (LPARAM)&psh); } // Show the property sheet PropertySheet(&psh); dwRet = (pcmi->fOK) ? NO_ERROR : ERROR_CANCELLED; } } end: if (pcmi) { if (pcmi->c.pProtocolCaps) { FREE_MEMORY(pcmi->c.pProtocolCaps); } FREE_MEMORY(pcmi); pcmi=NULL; } return dwRet; } DWORD CMI_Load( LPCFGMODEMINFO pcmi, LPCTSTR pszFriendlyName, UMDEVCFG *pDevCfg, HWND hwndParent ) { DWORD dwRet = ERROR_INVALID_PARAMETER; LPCOMMCONFIG pcc = &(pDevCfg->commconfig); LPMODEMSETTINGS pms = PmsFromPcc(pcc); LPFINDDEV pfd = NULL; DWORD cbData; if (!FindDev_Create(&pfd, c_pguidModem, c_szFriendlyName, pszFriendlyName)) { pfd = NULL; goto end; } ZeroMemory(pcmi, sizeof(*pcmi)); pcmi->dwSig = SIG_CFGMODEMINFO; dwRet = RegQueryModemCaps (pfd->hkeyDrv, &(pcmi->c)); if (ERROR_SUCCESS != dwRet) goto end; // Get the MaximumPortSpeed, as set by the user cbData = sizeof(DWORD); if (ERROR_SUCCESS != RegQueryValueEx (pfd->hkeyDrv, c_szMaximumPortSpeed, NULL, NULL, (LPBYTE)&pcmi->dwMaximumPortSpeed, &cbData)) { pcmi->dwMaximumPortSpeed = pcc->dcb.BaudRate; } pcmi->w.fdwSettings = MAKELONG(pDevCfg->dfgHdr.fwOptions, pDevCfg->dfgHdr.wWaitBong); pcmi->pdcfg = pDevCfg; BltByte(&pcmi->w.dcb, &pcc->dcb, sizeof(WIN32DCB)); BltByte(&pcmi->w.ms, pms, sizeof(MODEMSETTINGS)); lstrcpyn( pcmi->c.szFriendlyName, pszFriendlyName, SIZECHARS(pcmi->c.szFriendlyName) ); pcmi->hwndParent = hwndParent; DEBUG_CODE( DumpModemSettings(pms); ) DEBUG_CODE( DumpDCB(&pcc->dcb); ) DEBUG_CODE( DumpDevCaps(&pcmi->c.devcaps); ) dwRet = ERROR_SUCCESS; end: if (pfd) { FindDev_Destroy(pfd); pfd = NULL; } return dwRet; } void CMI_UnLoad( LPCFGMODEMINFO pcmi ) { ASSERT(pcmi->dwSig == SIG_CFGMODEMINFO); // Free any other stuff ... ZeroMemory(pcmi, sizeof(*pcmi)); } /*---------------------------------------------------------- Purpose: Release the data associated with the General page Returns: -- Cond: -- */ UINT CALLBACK CfgGeneralPageCallback( HWND hwnd, UINT uMsg, LPPROPSHEETPAGE ppsp) { // // NOTE: NO Global information is saved here! // if (PSPCB_RELEASE == uMsg) { LPCFGMODEMINFO pcmi = (LPCFGMODEMINFO)ppsp->lParam; ASSERT(pcmi); if (pcmi->fOK) { LPCOMMCONFIG pcc = &(pcmi->pdcfg->commconfig); LPMODEMSETTINGS pms = PmsFromPcc(pcc); DWORD dwRet; // Save the changes back to the commconfig struct TRACE_MSG(TF_GENERAL, "Copying DCB and MODEMSETTING back to COMMCONFIG"); BltByte(pms, &pcmi->w.ms, sizeof(MODEMSETTINGS)); BltByte(&pcc->dcb, &pcmi->w.dcb, sizeof(WIN32DCB)); pcmi->pdcfg->dfgHdr.fwOptions = LOWORD(pcmi->w.fdwSettings); pcmi->pdcfg->dfgHdr.wWaitBong = HIWORD(pcmi->w.fdwSettings); DEBUG_CODE( DumpModemSettings(pms); ) DEBUG_CODE( DumpDCB(&pcc->dcb); ) TRACE_MSG(TF_GENERAL, "Releasing the CPL General page"); } } return TRUE; } /*---------------------------------------------------------- Purpose: Add the General modems page. The pcmi is the pointer to the modeminfo buffer which we can edit. Returns: ERROR_ values Cond: -- */ DWORD PRIVATE CfgAddGeneralPage( LPCFGMODEMINFO pcmi, LPFNADDPROPSHEETPAGE pfnAdd, LPARAM lParam) { DWORD dwRet = ERROR_NOT_ENOUGH_MEMORY; PROPSHEETPAGE psp; HPROPSHEETPAGE hpage; TCHAR sz[MAXMEDLEN]; ASSERT(pcmi); ASSERT(pfnAdd); // Add the Port Settings property page // psp.dwSize = sizeof(PROPSHEETPAGE); psp.dwFlags = PSP_USECALLBACK; psp.hInstance = g_hinst; psp.pszTemplate = MAKEINTRESOURCE(IDD_CFG_GENERAL); psp.pfnDlgProc = CfgGen_WrapperProc; psp.lParam = (LPARAM)pcmi; psp.pfnCallback = CfgGeneralPageCallback; psp.pcRefParent = NULL; hpage = CreatePropertySheetPage(&psp); if (hpage) { if (!pfnAdd(hpage, lParam)) DestroyPropertySheetPage(hpage); else dwRet = NO_ERROR; } return dwRet; } BOOL ValidateDevConfig(UMDEVCFG *pDevCfg) { BOOL fRet = FALSE; DWORD dwCCSize = 0; if (!pDevCfg || pDevCfg->dfgHdr.dwSize <= sizeof (*pDevCfg)) { goto end; } if (pDevCfg->dfgHdr.dwVersion!=UMDEVCFG_VERSION) { goto end; } dwCCSize = pDevCfg->commconfig.dwSize; if (dwCCSize != CB_COMMCONFIGSIZE) { goto end; } if (pDevCfg->dfgHdr.dwSize != (sizeof(*pDevCfg) - sizeof(pDevCfg->commconfig) + CB_COMMCONFIGSIZE)) { goto end; } fRet = TRUE; end: return fRet; } // // DWORD RegQueryModemCaps( HKEY hkeyDrv, MODEMCAPS *pCaps ) { DWORD dwRet = ERROR_INVALID_PARAMETER; DWORD cbData; // Get the port name. There are two places the port name can be: // // 1) DriverKey\AttachedTo // This is for internal, external or null modems. This // port can be changed via the property sheet. // // Does this modem have a AttachedTo name? cbData = sizeof(pCaps->szPortName); dwRet = RegQueryValueEx( hkeyDrv, c_szAttachedTo, NULL, NULL, (LPBYTE)pCaps->szPortName, &cbData ); if (ERROR_SUCCESS != dwRet) { lstrcpy(pCaps->szPortName,TEXT("None")); dwRet=ERROR_SUCCESS; } // Get the device type { BYTE nDeviceType; cbData = sizeof(nDeviceType); dwRet = RegQueryValueEx( hkeyDrv, c_szDeviceType, NULL, NULL, (LPBYTE)&nDeviceType, &cbData ); if (ERROR_SUCCESS != dwRet) goto end; pCaps->dwDeviceType = nDeviceType; } // Get the properties (a portion of the MODEMDEVCAPS structure) cbData = sizeof(pCaps->devcaps); dwRet = RegQueryValueEx( hkeyDrv, c_szDeviceCaps, NULL, NULL, (LPBYTE)&pCaps->devcaps, &cbData ); if (ERROR_SUCCESS != dwRet) goto end; pCaps->devcaps.dwInactivityTimeout *= GetInactivityTimeoutScale( hkeyDrv ); // Get the protocol caps... #if 0 pCaps->pProtocolCaps = GetProtocolCaps(hkeyDrv); #else //1 { DWORD cbSize = 0; pCaps->pProtocolCaps = NULL; //DebugBreak(); dwRet = UnimodemGetExtendedCaps( hkeyDrv, &cbSize, NULL ); if (ERROR_SUCCESS==dwRet && cbSize) { pCaps->pProtocolCaps = (MODEM_PROTOCOL_CAPS*) ALLOCATE_MEMORY(cbSize); if (pCaps->pProtocolCaps) { dwRet = UnimodemGetExtendedCaps( hkeyDrv, &cbSize, (MODEM_CONFIG_HEADER*) (pCaps->pProtocolCaps) ); if (ERROR_SUCCESS!=dwRet) { // Ouch, error! FREE_MEMORY(pCaps->pProtocolCaps); pCaps->pProtocolCaps = NULL; } else { // // 3/29/1998 JosephJ: WARNING -- we could in principle // get other extended capabilities objects here, but we // assume that it only contains the protocol object, because // we implement UnimodemGetExtendedCaps here itself. // At such a point we make UnimodemGetExtendCaps return // more stuff, we'll have to pick out only the protocol // caps. // if (pCaps->pProtocolCaps->hdr.dwSig !=dwSIG_MODEM_PROTOCOL_CAPS) { ASSERT(FALSE); FREE_MEMORY(pCaps->pProtocolCaps); pCaps->pProtocolCaps = NULL; } } } } } #endif // 1 end: return dwRet; } MODEM_PROTOCOL_CAPS * GetProtocolCaps( HKEY hkDrv ) { MODEM_PROTOCOL_CAPS *pCaps = NULL; IDSTR *pidstrProtocolValues=NULL; UINT cProtocols=0; DWORD dwTotalSize = 0; // // Get the protocols supported... // (for now only ISDN!) // cProtocols = ReadIDSTR( hkDrv, "Protocol\\ISDN", rgidstrISDNCompatibleProtocols, (sizeof(rgidstrISDNCompatibleProtocols) /sizeof(rgidstrISDNCompatibleProtocols[0])), FALSE, &pidstrProtocolValues, NULL ); if (!cProtocols) { pidstrProtocolValues=NULL; goto end; } // Now allocate enough space for the CAPS structure dwTotalSize = sizeof(*pCaps) + sizeof(DWORD)*cProtocols; pCaps = ALLOCATE_MEMORY( dwTotalSize); if (!pCaps) { cProtocols = 0; goto end; } pCaps->hdr.dwSig = dwSIG_MODEM_PROTOCOL_CAPS; pCaps->hdr.dwTotalSize = dwTotalSize; pCaps->dwNumProtocols = cProtocols; pCaps->dwProtocolListOffset = sizeof(*pCaps); // set the array of protocols { DWORD *pdwDestProtocol = (DWORD*)(((BYTE*)pCaps)+pCaps->dwProtocolListOffset); UINT u=0; for (u=0;udwNumProtocols) { PROTOCOL_ITEM *pProtocolItem = (PROTOCOL_ITEM*) ( ((BYTE*)pCaps) + pCaps->dwProtocolListOffset); UINT u = pCaps->dwNumProtocols; while(u--) { if (pProtocolItem->dwProtocol == dwValue) { fRet = TRUE; break; } pProtocolItem++; } } return fRet; } DWORD APIENTRY UnimodemGetExtendedCaps( IN HKEY hKey, IN OUT LPDWORD pdwTotalSize, IN OUT MODEM_CONFIG_HEADER *pFirstObj // OPTIONAL ) { DWORD dwRet = ERROR_INVALID_PARAMETER; IDSTR **ppidstrISDNProtocols=NULL; IDSTR **ppidstrGSMProtocols=NULL; UINT cISDNProtocols=0; UINT cGSMProtocols=0; MODEM_PROTOCOL_CAPS *pCaps = NULL; DWORD dwNumProtocols=0; UINT cbTot = 0; UINT i; if (!pdwTotalSize) { // bad params.. goto end; } cISDNProtocols = FindKeys( hKey, "Protocol\\ISDN", rgidstrISDNCompatibleProtocols, (sizeof(rgidstrISDNCompatibleProtocols) /sizeof(rgidstrISDNCompatibleProtocols[0])), &ppidstrISDNProtocols ); cGSMProtocols = FindKeys( hKey, "Protocol\\GSM", rgidstrGSMCompatibleProtocols, (sizeof(rgidstrGSMCompatibleProtocols) /sizeof(rgidstrGSMCompatibleProtocols[0])), &ppidstrGSMProtocols ); dwNumProtocols = cISDNProtocols+cGSMProtocols; if (!dwNumProtocols) { // Nothing to report. We suceeed. *pdwTotalSize = 0; dwRet = 0; goto end; } cbTot = sizeof(MODEM_PROTOCOL_CAPS) + dwNumProtocols*sizeof(PROTOCOL_ITEM); for (i=0; idwID), NULL, 0, &SizeNeeded ); cbTot+=SizeNeeded; } for (i=0; idwID), NULL, 0, &SizeNeeded ); cbTot+=SizeNeeded; } if (!pFirstObj) { // // Just set the size and return. // *pdwTotalSize = cbTot; dwRet = 0; goto end; } if (cbTot > *pdwTotalSize) { // // Not enough space.... // dwRet = ERROR_INSUFFICIENT_BUFFER; goto end; } *pdwTotalSize = cbTot; ZeroMemory(pFirstObj, cbTot); pCaps = (MODEM_PROTOCOL_CAPS*) pFirstObj; pCaps->hdr.dwSig = dwSIG_MODEM_PROTOCOL_CAPS; pCaps->hdr.dwTotalSize = cbTot; pCaps->hdr.dwFlags = 0; pCaps->dwNumProtocols = dwNumProtocols; pCaps->dwProtocolListOffset = sizeof(MODEM_PROTOCOL_CAPS); // // Now we fill out the protocols ... we add the BEARERMODE // bits (ISDN/GSM) while doing so // { PROTOCOL_ITEM *ProtocolItem = (PPROTOCOL_ITEM)(pCaps+1); LPTSTR StringLocation=(LPTSTR)(ProtocolItem+pCaps->dwNumProtocols); UINT SizeNeeded; UINT u=0; // // ISDN ... // for (u=0;udwProtocol = MDM_GEN_EXTENDEDINFO( MDM_BEARERMODE_ISDN, ppidstrISDNProtocols[u]->dwID ); GetFriendlyProtocolName( MDM_GEN_EXTENDEDINFO(MDM_BEARERMODE_ISDN, ppidstrISDNProtocols[u]->dwID), StringLocation, cbTot-(DWORD)(((PUCHAR)StringLocation-(PUCHAR)pFirstObj)), &SizeNeeded ); ProtocolItem->dwProtocolNameOffset=((DWORD)((PUCHAR)StringLocation-(PUCHAR)pFirstObj)); ProtocolItem++; StringLocation+=SizeNeeded/sizeof(TCHAR); } // // GSM ... // for (u=0;udwProtocol = MDM_GEN_EXTENDEDINFO( MDM_BEARERMODE_GSM, ppidstrGSMProtocols[u]->dwID ); GetFriendlyProtocolName( MDM_GEN_EXTENDEDINFO(MDM_BEARERMODE_GSM, ppidstrGSMProtocols[u]->dwID), StringLocation, cbTot-(DWORD)(((PUCHAR)StringLocation-(PUCHAR)pFirstObj)), &SizeNeeded ); ProtocolItem->dwProtocolNameOffset=((DWORD)((PUCHAR)StringLocation-(PUCHAR)pFirstObj)); ProtocolItem++; StringLocation+=SizeNeeded/sizeof(TCHAR); } // // We should have filled out exactly as many elements as are in // the DWORD protocol array. // ASSERT((ProtocolItem-((PPROTOCOL_ITEM)(pCaps+1)))==(int)pCaps->dwNumProtocols); } dwRet = 0; // succes -- fall through ... end: if (ppidstrISDNProtocols) { FREE_MEMORY(ppidstrISDNProtocols); ppidstrISDNProtocols=NULL; } if (ppidstrGSMProtocols) { FREE_MEMORY(ppidstrGSMProtocols); ppidstrGSMProtocols=NULL; } return dwRet; } LONG GetFriendlyProtocolName( DWORD ProtocolId, LPTSTR FriendlyName, DWORD BufferLength, LPDWORD StringLength ) { DWORD i=0; while (s_rgErrorControl[i].dwValue != 0) { if (ProtocolId == s_rgErrorControl[i].dwValue) { break; } i++; } if (s_rgErrorControl[i].dwValue == 0) { // // did not find protocol // ASSERT(0); if (FriendlyName != NULL) { lstrcpyn(FriendlyName,TEXT("Unknown Protocol"),BufferLength/sizeof(TCHAR)); *StringLength = (lstrlen(FriendlyName)+1)*sizeof(TCHAR); return ERROR_SUCCESS; } else { *StringLength=sizeof(TEXT("Unknown Protocol")); return ERROR_SUCCESS; } } else { // // found the protocol, load the string // LONG CharactersCopied; if (FriendlyName != NULL) { CharactersCopied=LoadString( g_hinst, s_rgErrorControl[i].dwIDS, FriendlyName, BufferLength/sizeof(TCHAR) ); *StringLength=(CharactersCopied+1)*sizeof(TCHAR); return ERROR_SUCCESS; } else { // // just checking the length // TCHAR TempBuffer[1024]; CharactersCopied=LoadString( g_hinst, s_rgErrorControl[i].dwIDS, TempBuffer, sizeof(TempBuffer)/sizeof(TCHAR) ); *StringLength=(CharactersCopied+1)*sizeof(TCHAR); return ERROR_SUCCESS; } } return ERROR_SUCCESS; }