291 lines
7.9 KiB
C
291 lines
7.9 KiB
C
//---------------------------------------------------------------------------
|
|
//
|
|
// Copyright (c) Microsoft Corporation 1993-1996
|
|
//
|
|
// File: util.c
|
|
//
|
|
// This files contains all common utility routines
|
|
//
|
|
// History:
|
|
// 12-23-93 ScottH Created
|
|
// 09-22-95 ScottH Ported to NT
|
|
//
|
|
//---------------------------------------------------------------------------
|
|
|
|
#include "proj.h" // common headers
|
|
|
|
|
|
//-----------------------------------------------------------------------------------
|
|
// Wrapper that finds a device instance
|
|
//-----------------------------------------------------------------------------------
|
|
|
|
|
|
/*----------------------------------------------------------
|
|
Purpose: Enumerates the HKEY_LOCAL_MACHINE branch and finds the
|
|
device matching the given class and value. If there
|
|
are duplicate devices that match both criteria, only the
|
|
first device is returned.
|
|
|
|
Returns TRUE if the device was found.
|
|
|
|
Returns: see above
|
|
Cond: --
|
|
*/
|
|
BOOL
|
|
PRIVATE
|
|
FindDev_Find(
|
|
IN LPFINDDEV pfinddev,
|
|
IN LPGUID pguidClass, OPTIONAL
|
|
IN LPCTSTR pszValueName,
|
|
IN LPCTSTR pszValue)
|
|
{
|
|
BOOL bRet = FALSE;
|
|
TCHAR szKey[MAX_BUF];
|
|
TCHAR szName[MAX_BUF];
|
|
HDEVINFO hdi;
|
|
DWORD dwRW = KEY_READ;
|
|
|
|
ASSERT(pfinddev);
|
|
ASSERT(pszValueName);
|
|
ASSERT(pszValue);
|
|
|
|
if (USER_IS_ADMIN()) dwRW |= KEY_WRITE;
|
|
|
|
// (scotth): hack to support no device instances because
|
|
// ports do not have a class GUID. This should be fixed after SUR.
|
|
|
|
// Is there a class GUID?
|
|
if (pguidClass)
|
|
{
|
|
// Yes; use it
|
|
hdi = CplDiGetClassDevs(pguidClass, NULL, NULL, 0);
|
|
if (INVALID_HANDLE_VALUE != hdi)
|
|
{
|
|
SP_DEVINFO_DATA devData;
|
|
DWORD iIndex = 0;
|
|
HKEY hkey;
|
|
|
|
// Look for the modem that has the matching value
|
|
devData.cbSize = sizeof(devData);
|
|
while (CplDiEnumDeviceInfo(hdi, iIndex, &devData))
|
|
{
|
|
hkey = CplDiOpenDevRegKey(hdi, &devData, DICS_FLAG_GLOBAL, 0, DIREG_DRV, dwRW);
|
|
if (INVALID_HANDLE_VALUE != hkey)
|
|
{
|
|
// Does the value match?
|
|
DWORD cbData = sizeof(szName);
|
|
if (NO_ERROR == RegQueryValueEx(hkey, pszValueName, NULL, NULL,
|
|
(LPBYTE)szName, &cbData) &&
|
|
IsSzEqual(pszValue, szName))
|
|
{
|
|
// Yes
|
|
pfinddev->hkeyDrv = hkey;
|
|
pfinddev->hdi = hdi;
|
|
BltByte(&pfinddev->devData, &devData, sizeof(devData));
|
|
|
|
// Don't close the driver key or free the DeviceInfoSet,
|
|
// but exit
|
|
bRet = TRUE;
|
|
break;
|
|
}
|
|
RegCloseKey(hkey);
|
|
}
|
|
|
|
iIndex++;
|
|
}
|
|
|
|
// Free the DeviceInfoSet if nothing was found. Otherwise, we will
|
|
// retain these handles so the caller can make use of this.
|
|
if ( !bRet )
|
|
{
|
|
CplDiDestroyDeviceInfoList(hdi);
|
|
}
|
|
}
|
|
}
|
|
else
|
|
{
|
|
// No; HACK ALERT! Hmm, it must be a port class in SUR.
|
|
#pragma data_seg(DATASEG_READONLY)
|
|
static TCHAR const FAR c_szSerialComm[] = TEXT("HARDWARE\\DEVICEMAP\\SERIALCOMM");
|
|
#pragma data_seg()
|
|
|
|
HKEY hkeyEnum;
|
|
DWORD iSubKey;
|
|
TCHAR szName[MAX_BUF];
|
|
DWORD cbName;
|
|
DWORD cbData;
|
|
DWORD dwType;
|
|
DWORD dwRet;
|
|
|
|
dwRet = RegOpenKey(HKEY_LOCAL_MACHINE, c_szSerialComm, &hkeyEnum);
|
|
if (NO_ERROR == dwRet)
|
|
{
|
|
ZeroInit(pfinddev);
|
|
|
|
iSubKey = 0;
|
|
|
|
cbName = sizeof(szName) / sizeof(TCHAR);
|
|
cbData = sizeof(pfinddev->szPort) / sizeof(TCHAR);
|
|
|
|
while (NO_ERROR == RegEnumValue(hkeyEnum, iSubKey++, szName,
|
|
&cbName, NULL, &dwType,
|
|
(LPBYTE)pfinddev->szPort, &cbData))
|
|
{
|
|
if (REG_SZ == dwType &&
|
|
0 == lstrcmpi(pfinddev->szPort, pszValue))
|
|
{
|
|
bRet = TRUE;
|
|
break;
|
|
}
|
|
|
|
cbName = sizeof(szName);
|
|
cbData = sizeof(pfinddev->szPort);
|
|
}
|
|
RegCloseKey(hkeyEnum);
|
|
}
|
|
}
|
|
|
|
return bRet;
|
|
}
|
|
|
|
|
|
/*----------------------------------------------------------
|
|
Purpose: Creates a FINDDEV structure given the device class,
|
|
and a valuename and its value.
|
|
|
|
Returns: TRUE if the device is found in the system
|
|
|
|
Cond: --
|
|
*/
|
|
BOOL
|
|
PUBLIC
|
|
FindDev_Create(
|
|
OUT LPFINDDEV FAR * ppfinddev,
|
|
IN LPGUID pguidClass, OPTIONAL
|
|
IN LPCTSTR pszValueName,
|
|
IN LPCTSTR pszValue)
|
|
{
|
|
BOOL bRet;
|
|
LPFINDDEV pfinddev;
|
|
|
|
DEBUG_CODE( TRACE_MSG(TF_FUNC, " > FindDev_Create(....%s, %s, ...)",
|
|
Dbg_SafeStr(pszValueName), Dbg_SafeStr(pszValue)); )
|
|
|
|
ASSERT(ppfinddev);
|
|
ASSERT(pszValueName);
|
|
ASSERT(pszValue);
|
|
|
|
pfinddev = (LPFINDDEV)LocalAlloc(LPTR, sizeof(*pfinddev));
|
|
if (NULL == pfinddev)
|
|
{
|
|
bRet = FALSE;
|
|
}
|
|
else
|
|
{
|
|
bRet = FindDev_Find(pfinddev, pguidClass, pszValueName, pszValue);
|
|
|
|
if (FALSE == bRet)
|
|
{
|
|
// Didn't find anything
|
|
FindDev_Destroy(pfinddev);
|
|
pfinddev = NULL;
|
|
}
|
|
}
|
|
|
|
*ppfinddev = pfinddev;
|
|
|
|
DBG_EXIT_BOOL(FindDev_Create, bRet);
|
|
|
|
return bRet;
|
|
}
|
|
|
|
|
|
/*----------------------------------------------------------
|
|
Purpose: Destroys a FINDDEV structure
|
|
|
|
Returns: TRUE on success
|
|
Cond: --
|
|
*/
|
|
BOOL
|
|
PUBLIC
|
|
FindDev_Destroy(
|
|
IN LPFINDDEV this)
|
|
{
|
|
BOOL bRet;
|
|
|
|
if (NULL == this)
|
|
{
|
|
bRet = FALSE;
|
|
}
|
|
else
|
|
{
|
|
if (this->hkeyDrv)
|
|
RegCloseKey(this->hkeyDrv);
|
|
|
|
if (this->hdi && INVALID_HANDLE_VALUE != this->hdi)
|
|
CplDiDestroyDeviceInfoList(this->hdi);
|
|
|
|
LocalFreePtr(this);
|
|
|
|
bRet = TRUE;
|
|
}
|
|
|
|
return bRet;
|
|
}
|
|
|
|
|
|
//-----------------------------------------------------------------------------------
|
|
// Debug functions
|
|
//-----------------------------------------------------------------------------------
|
|
|
|
|
|
#ifdef DEBUG
|
|
|
|
#pragma data_seg(DATASEG_READONLY)
|
|
|
|
#ifdef WIN95
|
|
struct _RETERRMAP
|
|
{
|
|
RETERR ret;
|
|
LPCTSTR psz;
|
|
} const c_rgreterrmap[] = {
|
|
{ NO_ERROR, "NO_ERROR" },
|
|
{ DI_ERROR, "DI_ERROR" },
|
|
{ ERR_DI_INVALID_DEVICE_ID, "ERR_DI_INVALID_DEVICE_ID" },
|
|
{ ERR_DI_INVALID_COMPATIBLE_DEVICE_LIST, "ERR_DI_INVALID_COMPATIBLE_DEVICE_LIST" },
|
|
{ ERR_DI_REG_API, "ERR_DI_REG_API" },
|
|
{ ERR_DI_LOW_MEM, "ERR_DI_LOW_MEM" },
|
|
{ ERR_DI_BAD_DEV_INFO, "ERR_DI_BAD_DEV_INFO" },
|
|
{ ERR_DI_INVALID_CLASS_INSTALLER, "ERR_DI_INVALID_CLASS_INSTALLER" },
|
|
{ ERR_DI_DO_DEFAULT, "ERR_DI_DO_DEFAULT" },
|
|
{ ERR_DI_USER_CANCEL, "ERR_DI_USER_CANCEL" },
|
|
{ ERR_DI_NOFILECOPY, "ERR_DI_NOFILECOPY" },
|
|
{ ERR_DI_BAD_CLASS_INFO, "ERR_DI_BAD_CLASS_INFO" },
|
|
};
|
|
#endif
|
|
|
|
#pragma data_seg()
|
|
|
|
#ifdef WIN95
|
|
/*----------------------------------------------------------
|
|
Purpose: Returns the string form of a RETERR.
|
|
|
|
Returns: String ptr
|
|
Cond: --
|
|
*/
|
|
LPCTSTR PUBLIC Dbg_GetReterr(
|
|
RETERR ret)
|
|
{
|
|
int i;
|
|
|
|
for (i = 0; i < ARRAY_ELEMENTS(c_rgreterrmap); i++)
|
|
{
|
|
if (ret == c_rgreterrmap[i].ret)
|
|
return c_rgreterrmap[i].psz;
|
|
}
|
|
return "Unknown RETERR";
|
|
}
|
|
#endif // WIN95
|
|
|
|
#endif // DEBUG
|