windows-nt/Source/XPSP1/NT/printscan/fax/test/faxvrfy/startup.c

1005 lines
27 KiB
C
Raw Normal View History

2020-09-26 03:20:57 -05:00
/*++
Copyright (c) 1997 Microsoft Corporation
Module Name:
startup.c
Abstract:
This module:
1) Retrieves all the printer monitors
2) Verifies the fax printer monitor is installed
3) Retrieves all the printer ports
4) Verifies the fax printer port is installed
5) Retrieves all the printer drivers
6) Verifies the fax printer driver is installed
7) Retrieves all the printers
8) Verifies the fax printer is installed
9) Verifies fax is installed
10) Verifies the faxcom com objects are installed
11) Verifies the faxadmin com objects are installed
12) Verifies the routeext com objects are installed
13) Verifies the com objects are installed
14) Verifies the fax service is installed
15) Stops the fax service
16) Initializes FaxRcv
17) Initializes RAS
Author:
Steven Kehrli (steveke) 11/15/1997
--*/
#ifndef _STARTUP_C
#define _STARTUP_C
#include <winspool.h>
#include <faxcom.h>
#include <faxcom_i.c>
#include <faxadmin.h>
#include <faxadmin_i.c>
#include <routeext.h>
#include <routeext_i.c>
#define FAX_MONITOR_NAME L"Windows NT Fax Monitor" // FAX_MONITOR_NAME is the name of the Fax Printer Monitor
#define FAX_MONITOR_DLL L"msfaxmon.dll" // FAX_MONITOR_DLL is the name of the Fax Printer Monitor Dll
#define FAX_PORT_NAME L"MSFAX:" // FAX_PORT_NAME is the name of the Fax Printer Port
#define FAX_DRIVER_NAME L"Windows NT Fax Driver" // FAX_DRIVER_NAME is the name of the Fax Printer Driver
#define FAX_DRIVER_DLL L"faxdrv.dll" // FAX_DRIVER_DLL is the name of the Fax Printer Driver Dll
#define FAX_SERVICE L"Fax" // FAX_SERVICE is the name of the Fax Service
PVOID
fnLocalEnumPrinterMonitors(
LPDWORD pdwNumPrinterMonitors
)
/*++
Routine Description:
Retrieves all the printer monitors
Arguments:
pdwNumPrinterMonitors - pointer to number of printer monitors
Return Value:
PVOID - pointer to the printer monitors info
--*/
{
// pPrinterMonitorInfo is a pointer to a buffer of printer monitor info structures
LPBYTE pPrinterMonitorInfo;
// cb is the size of the buffer of printer driver info structures
DWORD cb;
*pdwNumPrinterMonitors = 0;
// Get all printer monitors
if ((!EnumMonitors(NULL, 2, NULL, 0, &cb, pdwNumPrinterMonitors)) && (GetLastError() == ERROR_INSUFFICIENT_BUFFER)) {
// EnumMonitors failed because the buffer is too small
// cb is the size of the buffer needed, so allocate a buffer of that size
pPrinterMonitorInfo = MemAllocMacro(cb);
// Call EnumMonitors again with the correct size buffer
if (!EnumMonitors(NULL, 2, pPrinterMonitorInfo, cb, &cb, pdwNumPrinterMonitors)) {
// EnumMonitors failed
// Free the buffer
MemFreeMacro(pPrinterMonitorInfo);
goto ExitLevel0;
}
// EnumMonitors succeeded, so return pointer to the buffer
return pPrinterMonitorInfo;
}
ExitLevel0:
// EnumMonitors failed
DebugMacro(L"EnumMonitors() failed, ec = 0x%08x\n", GetLastError());
// Return a NULL handle
return NULL;
}
BOOL
fnIsFaxPrinterMonitorInstalled(
)
/*++
Routine Description:
Verifies the fax printer monitor is installed
Return Value:
TRUE on success
--*/
{
// szDllPath is the path where the fax printer monitor dll resides
WCHAR szDllPath[_MAX_PATH];
// pAllPrinterMonitors is the pointer to all printer monitors info
LPMONITOR_INFO_2 pAllPrinterMonitors;
// dwNumPrinterMonitors is the number of all printer monitors
DWORD dwNumPrinterMonitors;
// dwNumFaxPrinterMonitors is the number of fax printer monitors
DWORD dwNumFaxPrinterMonitors;
// dwIndex is a counter to enumerate each printer monitor
DWORD dwIndex;
// Clear the dll path
ZeroMemory(szDllPath, sizeof(szDllPath));
// Get the path
if (GetSystemDirectory(szDllPath, sizeof(szDllPath)) == 0) {
DebugMacro(L"GetSystemDirectory() failed, ec = 0x%08x\n", GetLastError());
return FALSE;
}
// Concatenate the fax printer monitor dll with the path
lstrcat(szDllPath, L"\\");
lstrcat(szDllPath, FAX_MONITOR_DLL);
// Verify fax printer monitor dll exists
if (GetFileAttributes(szDllPath) == 0xFFFFFFFF) {
DebugMacro(L"The Fax Printer Monitor DLL does not exist.\n");
return FALSE;
}
// Get all printer monitors
pAllPrinterMonitors = fnLocalEnumPrinterMonitors(&dwNumPrinterMonitors);
if (!pAllPrinterMonitors)
// Return FALSE
return FALSE;
// Determine the number of fax printer monitors
for (dwIndex = 0, dwNumFaxPrinterMonitors = 0; dwIndex < dwNumPrinterMonitors; dwIndex++) {
// A fax printer monitor is determined by comparing the name of the current printer monitor against the name of the fax printer monitor
if ((!lstrcmpi(pAllPrinterMonitors[dwIndex].pName, FAX_MONITOR_NAME)) && (!lstrcmpi(pAllPrinterMonitors[dwIndex].pDLLName, FAX_MONITOR_DLL))) {
// Name of the current printer monitor and the name of the fax printer monitor match
// Increment the number of fax printer monitors
dwNumFaxPrinterMonitors++;
}
}
// Free all printer monitors
MemFreeMacro(pAllPrinterMonitors);
if (dwNumFaxPrinterMonitors == 1) {
return TRUE;
}
else if (dwNumFaxPrinterMonitors > 1) {
DebugMacro(L"The Fax Printer Monitor is installed more than once.\n");
return FALSE;
}
else {
DebugMacro(L"The Fax Printer Monitor is not installed.\n");
return FALSE;
}
}
PVOID
fnLocalEnumPrinterPorts(
LPDWORD pdwNumPrinterPorts
)
/*++
Routine Description:
Retrieves all the printer ports
Arguments:
pdwNumPrinterPorts - pointer to number of printer ports
Return Value:
PVOID - pointer to the printer ports info
--*/
{
// pPrinterPortInfo is a pointer to a buffer of printer port info structures
LPBYTE pPrinterPortInfo;
// cb is the size of the buffer of printer port info structures
DWORD cb;
*pdwNumPrinterPorts = 0;
// Get all printer ports
if ((!EnumPorts(NULL, 2, NULL, 0, &cb, pdwNumPrinterPorts)) && (GetLastError() == ERROR_INSUFFICIENT_BUFFER)) {
// EnumPorts failed because the buffer is too small
// cb is the size of the buffer needed, so allocate a buffer of that size
pPrinterPortInfo = MemAllocMacro(cb);
// Call EnumPorts again with the correct size buffer
if (!EnumPorts(NULL, 2, pPrinterPortInfo, cb, &cb, pdwNumPrinterPorts)) {
// EnumPorts failed
// Free the buffer
MemFreeMacro(pPrinterPortInfo);
goto ExitLevel0;
}
// EnumPorts succeeded, so return pointer to the buffer
return pPrinterPortInfo;
}
ExitLevel0:
// EnumPorts failed
DebugMacro(L"EnumPorts() failed, ec = 0x%08x\n", GetLastError());
// Return a NULL handle
return NULL;
}
BOOL
fnIsFaxPrinterPortInstalled(
)
/*++
Routine Description:
Verifies the fax printer port is installed
Return Value:
TRUE on success
--*/
{
// pAllPrinterPorts is the pointer to all printer ports info
LPPORT_INFO_2 pAllPrinterPorts;
// dwNumPrinterPorts is the number of all printer ports
DWORD dwNumPrinterPorts;
// dwNumFaxPrinterPorts is the number of fax printer ports
DWORD dwNumFaxPrinterPorts;
// dwIndex is a counter to enumerate each printer ports
DWORD dwIndex;
// Get all printer ports
pAllPrinterPorts = fnLocalEnumPrinterPorts(&dwNumPrinterPorts);
if (!pAllPrinterPorts) {
// Return FALSE
return FALSE;
}
// Determine the number of fax printer ports
for (dwIndex = 0, dwNumFaxPrinterPorts = 0; dwIndex < dwNumPrinterPorts; dwIndex++) {
// A fax printer port is determined by comparing the name of the current printer port against the name of the fax printer port
if ((!lstrcmpi(pAllPrinterPorts[dwIndex].pPortName, FAX_PORT_NAME)) && (!lstrcmpi(pAllPrinterPorts[dwIndex].pMonitorName, FAX_MONITOR_NAME))) {
// Name of the current printer port and the name of the fax printer port match
// Increment the number of fax printer ports
dwNumFaxPrinterPorts++;
}
}
// Free all printer ports
MemFreeMacro(pAllPrinterPorts);
if (dwNumFaxPrinterPorts == 1) {
return TRUE;
}
else if (dwNumFaxPrinterPorts > 1) {
DebugMacro(L"The Fax Printer Port is installed more than once.\n");
return FALSE;
}
else {
DebugMacro(L"The Fax Printer Port is not installed.\n");
return FALSE;
}
}
PVOID
fnLocalEnumPrinterDrivers(
LPDWORD pdwNumPrinterDrivers
)
/*++
Routine Description:
Retrieves all the printer drivers
Arguments:
pdwNumPrinterDrivers - pointer to number of printer drivers
Return Value:
PVOID - pointer to the printer drivers info
--*/
{
// pPrinterDriverInfo is a pointer to a buffer of printer driver info structures
LPBYTE pPrinterDriverInfo;
// cb is the size of the buffer of printer driver info structures
DWORD cb;
*pdwNumPrinterDrivers = 0;
// Get all printer drivers
if ((!EnumPrinterDrivers(NULL, NULL, 2, NULL, 0, &cb, pdwNumPrinterDrivers)) && (GetLastError() == ERROR_INSUFFICIENT_BUFFER)) {
// EnumPrinterDrivers failed because the buffer is too small
// cb is the size of the buffer needed, so allocate a buffer of that size
pPrinterDriverInfo = MemAllocMacro(cb);
// Call EnumPrinterDrivers again with the correct size buffer
if (!EnumPrinterDrivers(NULL, NULL, 2, pPrinterDriverInfo, cb, &cb, pdwNumPrinterDrivers)) {
// EnumPrinterDrivers failed
// Free the buffer
MemFreeMacro(pPrinterDriverInfo);
goto ExitLevel0;
}
// EnumPrinterDrivers succeeded, so return pointer to the buffer
return pPrinterDriverInfo;
}
ExitLevel0:
// EnumPrinterDrivers failed
DebugMacro(L"EnumPrinterDrivers() failed, ec = 0x%08x\n", GetLastError());
// Return a NULL handle
return NULL;
}
BOOL
fnIsFaxPrinterDriverInstalled(
)
/*++
Routine Description:
Verifies the fax printer driver is installed
Return Value:
TRUE on success
--*/
{
// pAllPrinterDrivers is the pointer to all printer drivers info
LPDRIVER_INFO_2 pAllPrinterDrivers;
// dwNumPrinterDrivers is the number of all printer drivers
DWORD dwNumPrinterDrivers;
// dwNumFaxPrinterDrivers is the number of fax printer drivers
DWORD dwNumFaxPrinterDrivers;
// dwIndex is a counter to enumerate each printer driver
DWORD dwIndex;
DWORD cb;
// Get all printer drivers
pAllPrinterDrivers = fnLocalEnumPrinterDrivers(&dwNumPrinterDrivers);
if (!pAllPrinterDrivers)
// Return FALSE
return FALSE;
// Determine the number of fax printer drivers
for (dwIndex = 0, dwNumFaxPrinterDrivers = 0; dwIndex < dwNumPrinterDrivers; dwIndex++) {
// A fax printer driver is determined by comparing the name of the current printer driver against the name of the fax printer driver
if ((!lstrcmpi(pAllPrinterDrivers[dwIndex].pName, FAX_DRIVER_NAME)) && (!lstrcmpi((LPWSTR) ((UINT_PTR) pAllPrinterDrivers[dwIndex].pDriverPath + (lstrlen(pAllPrinterDrivers[dwIndex].pDriverPath) - lstrlen(FAX_DRIVER_DLL)) * sizeof(WCHAR)), FAX_DRIVER_DLL)) && (GetFileAttributes(pAllPrinterDrivers[dwIndex].pDriverPath) != 0xFFFFFFFF)) {
// Name of the current printer driver and the name of the fax printer driver match
// Increment the number of fax printer drivers
dwNumFaxPrinterDrivers++;
}
}
// Free all printer drivers
MemFreeMacro(pAllPrinterDrivers);
if (dwNumFaxPrinterDrivers == 1) {
return TRUE;
}
else if (dwNumFaxPrinterDrivers > 1) {
DebugMacro(L"The Fax Printer Driver is installed more than once.\n");
return FALSE;
}
else {
DebugMacro(L"The Fax Printer Driver is not installed.\n");
return FALSE;
}
}
PVOID
fnLocalEnumPrinters(
LPDWORD pdwNumPrinters
)
/*++
Routine Description:
Retrieves all the printers
Arguments:
pdwNumPrinters - pointer to number of printers
Return Value:
PVOID - pointer to the printer info
--*/
{
// pPrinterInfo is a pointer to a buffer of printer info structures
LPBYTE pPrinterInfo;
// cb is the size of the buffer of printer info structures
DWORD cb;
*pdwNumPrinters = 0;
// Get all printers
if ((!EnumPrinters(PRINTER_ENUM_LOCAL, NULL, 2, NULL, 0, &cb, pdwNumPrinters)) && (GetLastError() == ERROR_INSUFFICIENT_BUFFER)) {
// EnumPrinters failed because the buffer is too small
// cb is the size of the buffer needed, so allocate a buffer of that size
pPrinterInfo = MemAllocMacro(cb);
// Call EnumPrinters again with the correct size buffer
if (!EnumPrinters(PRINTER_ENUM_LOCAL, NULL, 2, pPrinterInfo, cb, &cb, pdwNumPrinters)) {
// EnumPrinters failed
// Free the buffer
MemFreeMacro(pPrinterInfo);
goto ExitLevel0;
}
// EnumPrinters succeeded, so return pointer to the buffer
return pPrinterInfo;
}
ExitLevel0:
// EnumPrinters failed
DebugMacro(L"EnumPrinters() failed, ec = 0x%08x\n", GetLastError());
// Return a NULL handle
return NULL;
}
BOOL
fnIsFaxPrinterInstalled(
)
/*++
Routine Description:
Verifies the fax printer is installed
Return Value:
TRUE on success
--*/
{
// pPrinterInfo is the pointer to all printers info
LPPRINTER_INFO_2 pAllPrinters;
// dwNumPrinters is the number of all printers
DWORD dwNumPrinters;
// dwNumFaxPrinters is the number of fax printers
DWORD dwNumFaxPrinters;
// dwIndex is a counter to enumerate each printer
DWORD dwIndex;
// Get all printers
pAllPrinters = fnLocalEnumPrinters(&dwNumPrinters);
if (!pAllPrinters)
// Return FALSE
return FALSE;
// Determine the number of fax printers
for (dwIndex = 0, dwNumFaxPrinters = 0; dwIndex < dwNumPrinters; dwIndex++) {
// A fax printer is determined by comparing the name of the current printer driver against the name of the fax printer driver
if ((!lstrcmpi(pAllPrinters[dwIndex].pDriverName, FAX_DRIVER_NAME)) && (!lstrcmpi(pAllPrinters[dwIndex].pPortName, FAX_PORT_NAME))) {
// Name of the current printer driver and the name of the fax printer driver match
// Increment the number of fax printers
dwNumFaxPrinters++;
}
}
// Free all printers
MemFreeMacro(pAllPrinters);
if (dwNumFaxPrinters) {
return TRUE;
}
else {
DebugMacro(L"A Fax Printer is not installed.\n");
return FALSE;
}
}
UINT
fnIsFaxInstalled(
)
/*++
Routine Description:
Verifies fax is installed
Return Value:
UINT - resource id
--*/
{
// Verify the fax printer monitor is installed
if (!fnIsFaxPrinterMonitorInstalled()) {
return IDS_FAX_MONITOR_NOT_INSTALLED;
}
// Verify the fax printer port is installed
if (!fnIsFaxPrinterPortInstalled()) {
return IDS_FAX_PORT_NOT_INSTALLED;
}
// Verify the fax printer driver is installed
if (!fnIsFaxPrinterDriverInstalled()) {
return IDS_FAX_DRIVER_NOT_INSTALLED;
}
// Verify the fax printer is installed
if (!fnIsFaxPrinterInstalled()) {
return IDS_FAX_PRINTER_NOT_INSTALLED;
}
return ERROR_SUCCESS;
}
BOOL
fnIsFaxComInstalled(
)
/*++
Routine Description:
Verifies the faxcom com objects are installed
Return Value:
TRUE on success
--*/
{
HRESULT hResult;
IFaxTiff *pIFaxTiff;
hResult = CoCreateInstance((REFCLSID) &CLSID_FaxTiff, NULL, CLSCTX_INPROC_SERVER, &IID_IFaxTiff, &pIFaxTiff);
if (hResult != S_OK) {
DebugMacro(L"CoCreateInstance(CLSID_FaxTiff, IID_IFaxTiff) failed, ec = 0x%08x\n", hResult);
return FALSE;
}
pIFaxTiff->lpVtbl->Release(pIFaxTiff);
return TRUE;
}
BOOL
fnIsFaxAdminInstalled(
)
/*++
Routine Description:
Verifies the faxadmin com objects are installed
Return Value:
TRUE on success
--*/
{
HRESULT hResult;
IFaxSnapin *pIFaxSnapin;
hResult = CoCreateInstance((REFCLSID) &CLSID_FaxSnapin, NULL, CLSCTX_INPROC_SERVER, &IID_IFaxSnapin, &pIFaxSnapin);
if (hResult != S_OK) {
DebugMacro(L"CoCreateInstance(CLSID_FaxSnapin, IID_IFaxSnapin) failed, ec = 0x%08x\n", hResult);
return FALSE;
}
pIFaxSnapin->lpVtbl->Release(pIFaxSnapin);
return TRUE;
}
BOOL
fnIsRouteExtInstalled(
)
/*++
Routine Description:
Verifies the routeext com objects are installed
Return Value:
TRUE on success
--*/
{
HRESULT hResult;
IUnknown *pRoute;
hResult = CoCreateInstance((REFCLSID) &CLSID_Route, NULL, CLSCTX_INPROC_SERVER, &IID_IUnknown, &pRoute);
if (hResult != S_OK) {
DebugMacro(L"CoCreateInstance(CLSID_Route, IID_IUnknown) failed, ec = 0x%08x\n", hResult);
return FALSE;
}
pRoute->lpVtbl->Release(pRoute);
return TRUE;
}
UINT
fnIsComInstalled(
)
/*++
Routine Description:
Verifies the com objects are installed
Return Value:
UINT - resource id
--*/
{
HRESULT hResult;
UINT uRslt;
hResult = CoInitialize(NULL);
if (hResult != S_OK) {
DebugMacro(L"CoInitialize() failed, ec = 0x%08x\n", hResult);
uRslt = IDS_COM_NOT_INITIALIZED;
}
if (!fnIsFaxComInstalled()) {
uRslt = IDS_FAXCOM_NOT_INSTALLED;
}
if (!fnIsFaxAdminInstalled()) {
uRslt = IDS_FAXADMIN_NOT_INSTALLED;
}
if (!fnIsRouteExtInstalled()) {
uRslt = IDS_ROUTEEXT_NOT_INSTALLED;
}
uRslt = ERROR_SUCCESS;
CoUninitialize();
return uRslt;
}
BOOL
fnIsFaxSvcInstalled(
)
/*++
Routine Description:
Verifies the fax service is installed
Return Value:
TRUE on success
--*/
{
SC_HANDLE hManager = NULL;
SC_HANDLE hService = NULL;
// Open the service control manager
hManager = OpenSCManager(NULL, SERVICES_ACTIVE_DATABASE, SC_MANAGER_ALL_ACCESS);
if (!hManager) {
DebugMacro(L"OpenSCManager() failed, ec = 0x%08x\n", GetLastError());
return FALSE;
}
// Open the service
hService = OpenService(hManager, FAX_SERVICE, SERVICE_ALL_ACCESS);
if (!hService) {
CloseServiceHandle(hManager);
DebugMacro(L"OpenService() failed, ec = 0x%08x\n", GetLastError());
return FALSE;
}
CloseServiceHandle(hService);
CloseServiceHandle(hManager);
return TRUE;
}
BOOL
fnStopFaxSvc(
)
/*++
Routine Description:
Stops the fax service
Return Value:
TRUE on success
--*/
{
SC_HANDLE hManager;
SC_HANDLE hService;
SERVICE_STATUS ServiceStatus;
BOOL bRslt;
bRslt = FALSE;
// Open the service control manager
hManager = OpenSCManager(NULL, SERVICES_ACTIVE_DATABASE, SC_MANAGER_ALL_ACCESS);
if (!hManager) {
DebugMacro(L"OpenSCManager() failed, ec = 0x%08x\n", GetLastError());
goto ExitLevel0;
}
// Open the service
hService = OpenService(hManager, FAX_SERVICE, SERVICE_ALL_ACCESS);
if (!hService) {
DebugMacro(L"OpenService() failed, ec = 0x%08x\n", GetLastError());
goto ExitLevel0;
}
// Query the service status
ZeroMemory(&ServiceStatus, sizeof(SERVICE_STATUS));
if (!QueryServiceStatus(hService, &ServiceStatus)) {
DebugMacro(L"QueryServiceStatus() failed, ec = 0x%08x\n", GetLastError());
goto ExitLevel0;
}
if (ServiceStatus.dwCurrentState == SERVICE_STOPPED) {
// Service is stopped
bRslt = TRUE;
goto ExitLevel0;
}
// Stop the service
if (!ControlService(hService, SERVICE_CONTROL_STOP, &ServiceStatus)) {
DebugMacro(L"ControlService() failed, ec = 0x%08x\n", GetLastError());
goto ExitLevel0;
}
// Wait until the service is stopped
ZeroMemory(&ServiceStatus, sizeof(SERVICE_STATUS));
while (ServiceStatus.dwCurrentState != SERVICE_STOPPED) {
Sleep(1000);
// Query the service status
if (!QueryServiceStatus(hService, &ServiceStatus)) {
DebugMacro(L"QueryServiceStatus() failed, ec = 0x%08x\n", GetLastError());
goto ExitLevel0;
}
// Verify the service is stopped or stopping
if (!((ServiceStatus.dwCurrentState == SERVICE_STOPPED) || (ServiceStatus.dwCurrentState == SERVICE_STOP_PENDING))) {
DebugMacro(L"The Fax Service is in an unexpected state. dwCurrentState: 0x%08x\n", ServiceStatus.dwCurrentState);
goto ExitLevel0;
}
}
bRslt = TRUE;
Sleep(1000);
ExitLevel0:
if (hService) {
CloseServiceHandle(hService);
}
if (hManager) {
CloseServiceHandle(hManager);
}
return bRslt;
}
UINT
fnInitializeFaxRcv(
)
/*++
Routine Description:
Initializes FaxRcv
Return Value:
UINT - resource id
--*/
{
// szFaxRcvDll is the FaxRcv dll
WCHAR szFaxRcvDll[_MAX_PATH];
// hFaxRcvExtKey is the handle to the FaxRcv Extension Registry key
HKEY hFaxRcvExtKey;
// hRoutingMethodsKey is the handle to the FaxRcv Routing Methods Registry key
HKEY hRoutingMethodsKey;
// hFaxRcvMethodKey is the handle to the FaxRcv Method Registry key
HKEY hFaxRcvMethodKey;
DWORD dwDisposition;
DWORD dwData;
LPWSTR szData;
UINT uRslt;
uRslt = IDS_FAX_RCV_NOT_INITIALIZED;
if (!fnIsFaxSvcInstalled()) {
return IDS_FAX_SVC_NOT_INSTALLED;
}
if (!fnStopFaxSvc()) {
return IDS_FAX_SVC_NOT_STOPPED;
}
ExpandEnvironmentStrings(IMAGENAME_EXT_REGDATA, szFaxRcvDll, sizeof(szFaxRcvDll) / sizeof(WCHAR));
if (!lstrcmpi(IMAGENAME_EXT_REGDATA, szFaxRcvDll)) {
return IDS_FAX_RCV_NOT_INITIALIZED;
}
// Copy the FaxRcv dll
if (!CopyFile(FAXRCV_DLL, szFaxRcvDll, FALSE)) {
return IDS_FAX_RCV_NOT_INITIALIZED;
}
// Create or open the FaxRcv Extension Registry key
if (RegCreateKeyEx(HKEY_LOCAL_MACHINE, FAXRCV_EXT_REGKEY, 0, NULL, REG_OPTION_NON_VOLATILE, KEY_ALL_ACCESS, NULL, &hFaxRcvExtKey, &dwDisposition) != ERROR_SUCCESS) {
return IDS_FAX_RCV_NOT_INITIALIZED;
}
// Create or open the FaxRcv Routing Methods Registry key
if (RegCreateKeyEx(hFaxRcvExtKey, ROUTINGMETHODS_REGKEY, 0, NULL, REG_OPTION_NON_VOLATILE, KEY_ALL_ACCESS, NULL, &hRoutingMethodsKey, &dwDisposition) != ERROR_SUCCESS) {
goto ExitLevel0;
}
// Create or open the FaxRcv Method Registry key
if (RegCreateKeyEx(hRoutingMethodsKey, FAXRCV_METHOD_REGKEY, 0, NULL, REG_OPTION_NON_VOLATILE, KEY_ALL_ACCESS, NULL, &hFaxRcvMethodKey, &dwDisposition) != ERROR_SUCCESS) {
goto ExitLevel1;
}
// Set FaxRcv Extension bEnable Registry value
dwData = BENABLE_EXT_REGDATA;
if (RegSetValueEx(hFaxRcvExtKey, BENABLE_EXT_REGVAL, 0, REG_DWORD, (PBYTE) &dwData, sizeof(DWORD)) != ERROR_SUCCESS) {
goto ExitLevel2;
}
// Set FaxRcv Extension FriendlyName Registry value
szData = FRIENDLYNAME_EXT_REGDATA;
if (RegSetValueEx(hFaxRcvExtKey, FRIENDLYNAME_EXT_REGVAL, 0, REG_SZ, (PBYTE) szData, (lstrlen(szData) + 1) * sizeof(WCHAR)) != ERROR_SUCCESS) {
goto ExitLevel2;
}
// Set FaxRcv Extension ImageName Registry value
szData = IMAGENAME_EXT_REGDATA;
if (RegSetValueEx(hFaxRcvExtKey, IMAGENAME_EXT_REGVAL, 0, REG_EXPAND_SZ, (PBYTE) szData, (lstrlen(szData) + 1) * sizeof(WCHAR)) != ERROR_SUCCESS) {
goto ExitLevel2;
}
// Set FaxRcv Method FriendlyName Registry value
szData = FRIENDLYNAME_METHOD_REGDATA;
if (RegSetValueEx(hFaxRcvMethodKey, FRIENDLYNAME_METHOD_REGVAL, 0, REG_SZ, (PBYTE) szData, (lstrlen(szData) + 1) * sizeof(WCHAR)) != ERROR_SUCCESS) {
goto ExitLevel2;
}
// Set FaxRcv Method FunctionName Registry value
szData = FUNCTIONNAME_METHOD_REGDATA;
if (RegSetValueEx(hFaxRcvMethodKey, FUNCTIONNAME_METHOD_REGVAL, 0, REG_SZ, (PBYTE) szData, (lstrlen(szData) + 1) * sizeof(WCHAR)) != ERROR_SUCCESS) {
goto ExitLevel2;
}
// Set FaxRcv Method Guid Registry value
szData = GUID_METHOD_REGDATA;
if (RegSetValueEx(hFaxRcvMethodKey, GUID_METHOD_REGVAL, 0, REG_SZ, (PBYTE) szData, (lstrlen(szData) + 1) * sizeof(WCHAR)) != ERROR_SUCCESS) {
goto ExitLevel2;
}
// Set FaxRcv Method Priority Registry value
dwData = PRIORITY_METHOD_REGDATA;
if (RegSetValueEx(hFaxRcvMethodKey, PRIORITY_METHOD_REGVAL, 0, REG_DWORD, (PBYTE) &dwData, sizeof(DWORD)) != ERROR_SUCCESS) {
goto ExitLevel2;
}
uRslt = ERROR_SUCCESS;
ExitLevel2:
// Close the FaxRcv Method Registry key
RegCloseKey(hFaxRcvMethodKey);
ExitLevel1:
// Close the FaxRcv Routing Methods Registry key
RegCloseKey(hRoutingMethodsKey);
ExitLevel0:
// Close the FaxRcv Extension Registry key
RegCloseKey(hFaxRcvExtKey);
return uRslt;
}
BOOL
fnInitializeRas(
)
/*++
Routine Description:
Initializes RAS
Return Value:
TRUE on success
--*/
{
// szDllPath is the path where the RAS dll resides
WCHAR szDllPath[_MAX_PATH];
// hInstance is the handle to the RAS dll
HINSTANCE hInstance;
// Clear the dll path
ZeroMemory(szDllPath, sizeof(szDllPath));
// Get the path
if (GetSystemDirectory(szDllPath, sizeof(szDllPath)) == 0) {
DebugMacro(L"GetSystemDirectory() failed, ec = 0x%08x\n", GetLastError());
return FALSE;
}
// Concatenate the RAS dll with the path
lstrcat(szDllPath, RASAPI32_DLL);
// Get the handle to the RAS dll
hInstance = LoadLibrary((LPCWSTR) szDllPath);
if (!hInstance) {
DebugMacro(L"LoadLibrary(%s) failed, ec = 0x%08x\n", szDllPath, GetLastError());
return FALSE;
}
// Map all needed functions
g_RasApi.hInstance = hInstance;
// RasDial
g_RasApi.RasDial = GetProcAddress(hInstance, "RasDialW");
if (!g_RasApi.RasDial) {
DebugMacro(L"GetProcAddress(RasDial) failed, ec = 0x%08x\n", GetLastError());
FreeLibrary(hInstance);
return FALSE;
}
// RasGetErrorString
g_RasApi.RasGetErrorString = GetProcAddress(hInstance, "RasGetErrorStringW");
if (!g_RasApi.RasGetErrorString) {
DebugMacro(L"GetProcAddress(RasGetErrorString) failed, ec = 0x%08x\n", GetLastError());
FreeLibrary(hInstance);
return FALSE;
}
// RasGetConnectStatus
g_RasApi.RasGetConnectStatus = GetProcAddress(hInstance, "RasGetConnectStatusW");
if (!g_RasApi.RasGetConnectStatus) {
DebugMacro(L"GetProcAddress(RasGetConnectStatus) failed, ec = 0x%08x\n", GetLastError());
FreeLibrary(hInstance);
return FALSE;
}
// RasGetConnectionStatistics
g_RasApi.RasGetConnectionStatistics = GetProcAddress(hInstance, "RasGetConnectionStatistics");
if (!g_RasApi.RasGetConnectionStatistics) {
DebugMacro(L"GetProcAddress(RasGetConnectionStatistics) failed, ec = 0x%08x\n", GetLastError());
FreeLibrary(hInstance);
return FALSE;
}
// RasHangUp
g_RasApi.RasHangUp = GetProcAddress(hInstance, "RasHangUpW");
if (!g_RasApi.RasHangUp) {
DebugMacro(L"GetProcAddress(RasHangUp) failed, ec = 0x%08x\n", GetLastError());
FreeLibrary(hInstance);
return FALSE;
}
return TRUE;
}
#endif