archive
/
windows-server-2003
mirror of https://github.com/selfrender/Windows-Server-2003
2
0
Fork 0
Code Issues Projects Releases Wiki Activity
Leaked source code of windows server 2003
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
4 Commits
1 Branch
0 Tags
1.5 GiB
 
 
 
 
 
 
Branch: master
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'master'
${ noResults }
windows-server-2003/printscan/faxsrv/service/client/config.c

5399 lines
136 KiB
Raw Permalink Blame History

/*++
Copyright (c) 1996 Microsoft Corporation
Module Name:
config.c
Abstract:
This module contains the configuration
specific WINFAX API functions.
Author:
Wesley Witt (wesw) 29-Nov-1996
Revision History:
--*/
#include "faxapi.h"
#pragma hdrstop
#include <mbstring.h>
BOOL
WINAPI
FaxGetConfigurationW(
IN HANDLE FaxHandle,
OUT PFAX_CONFIGURATIONW *FaxConfig
)
/*++
Routine Description:
Retrieves the FAX configuration from the FAX server.
The SizeOfStruct in the FaxConfig argument MUST be
set to a value=>= sizeof(FAX_CONFIGURATION).
Arguments:
FaxHandle - FAX handle obtained from FaxConnectFaxServer.
FaxConfig - Pointer to a FAX_CONFIGURATION structure.
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DWORD FaxConfigSize = 0;
DEBUG_FUNCTION_NAME(TEXT("FaxGetConfigurationW"));
if (!ValidateFaxHandle(FaxHandle,FHT_SERVICE)) {
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!FaxConfig) {
SetLastError( ERROR_INVALID_PARAMETER );
DebugPrintEx(DEBUG_ERR, _T("FaxConfig is NULL."));
return FALSE;
}
*FaxConfig = NULL;
//
__try
{
ec = FAX_GetConfiguration(
FH_FAX_HANDLE(FaxHandle),
(LPBYTE*)FaxConfig,
&FaxConfigSize
);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_GetConfiguration. (ec: %ld)"),
ec);
}
if (ec)
{
DumpRPCExtendedStatus();
SetLastError( ec );
return FALSE;
}
FixupStringPtrW( FaxConfig, (*FaxConfig)->ArchiveDirectory );
(*FaxConfig)->Reserved = NULL;
return TRUE;
}
BOOL
WINAPI
FaxGetConfigurationA(
IN HANDLE FaxHandle,
OUT PFAX_CONFIGURATIONA *FaxConfigA
)
/*++
Routine Description:
Retrieves the FAX configuration from the FAX server.
The SizeOfStruct in the FaxConfig argument MUST be
set to a value=>= sizeof(FAX_CONFIGURATION).
Arguments:
FaxHandle - FAX handle obtained from FaxConnectFaxServer.
FaxConfig - Pointer to a FAX_CONFIGURATION structure.
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
DEBUG_FUNCTION_NAME(TEXT("FaxGetConfigurationA"));
//
// No need to Validate Parameters, FaxGetConfigurationW() will do that
//
if (!FaxGetConfigurationW(
FaxHandle,
(PFAX_CONFIGURATIONW*) FaxConfigA
))
{
DebugPrintEx(DEBUG_ERR, _T("FaxGetConfigurationW() is failed, ec = %ld."), GetLastError());
return FALSE;
}
if (!ConvertUnicodeStringInPlace((LPWSTR) (*FaxConfigA)->ArchiveDirectory))
{
DebugPrintEx(DEBUG_ERR, _T("ConvertUnicodeStringInPlace failed, ec = %ld."), GetLastError());
MemFree (*FaxConfigA);
return FALSE;
}
(*FaxConfigA)->SizeOfStruct = sizeof(FAX_CONFIGURATIONA);
return TRUE;
} // FaxGetConfigurationA
BOOL
WINAPI
FaxSetConfigurationW(
IN HANDLE FaxHandle,
IN const FAX_CONFIGURATIONW *FaxConfig
)
/*++
Routine Description:
Changes the FAX configuration on the FAX server.
The SizeOfStruct in the FaxConfig argument MUST be
set to a value == sizeof(FAX_CONFIGURATION).
Arguments:
FaxHandle - FAX handle obtained from FaxConnectFaxServer.
FaxConfig - Pointer to a FAX_CONFIGURATION structure.
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxSetConfigurationW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(FaxHandle,FHT_SERVICE)) {
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!FaxConfig) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("FaxConfig() is NULL."));
return FALSE;
}
if (FaxConfig->SizeOfStruct != sizeof(FAX_CONFIGURATIONW)) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("FaxConfig->SizeOfStruct != sizeof(FAX_CONFIGURATIONW)"));
return FALSE;
}
__try
{
ec = FAX_SetConfiguration( FH_FAX_HANDLE(FaxHandle), FaxConfig );
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(DEBUG_ERR,
_T("Exception on RPC call to FAX_SetConfiguration. (ec: %ld)"),
ec);
}
if (ec)
{
DumpRPCExtendedStatus();
SetLastError( ec );
return FALSE;
}
return TRUE;
}
BOOL
WINAPI
FaxSetConfigurationA(
IN HANDLE FaxHandle,
IN const FAX_CONFIGURATIONA *FaxConfig
)
{
error_status_t ec = ERROR_SUCCESS;
FAX_CONFIGURATIONW FaxConfigW;
DEBUG_FUNCTION_NAME(TEXT("FaxSetConfigurationA"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(FaxHandle,FHT_SERVICE)) {
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!FaxConfig) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("FaxConfig is NULL."));
return FALSE;
}
if (FaxConfig->SizeOfStruct != sizeof(FAX_CONFIGURATIONA)) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("FaxConfig->SizeOfStruct != sizeof(FAX_CONFIGURATIONA)."));
return FALSE;
}
//
// ansi structure is same size as unicode structure, so we can just copy it, then
// cast the string pointers correctly
//
CopyMemory(&FaxConfigW,FaxConfig,sizeof(FAX_CONFIGURATIONA));
if (FaxConfig->ArchiveDirectory)
{
if (NULL == (FaxConfigW.ArchiveDirectory = AnsiStringToUnicodeString(FaxConfig->ArchiveDirectory)))
{
ec = ERROR_OUTOFMEMORY;
DebugPrintEx(DEBUG_ERR,
_T("AnsiStringToUnicodeString(FaxConfig->ArchiveDirectory) returns NULL."));
goto exit;
}
}
//
// Set InboundProfile to NULL
//
FaxConfigW.Reserved = NULL;
__try
{
ec = FAX_SetConfiguration( FH_FAX_HANDLE(FaxHandle),
(PFAX_CONFIGURATIONW)&FaxConfigW );
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_SetConfiguration. (ec: %ld)"),
ec);
}
exit:
if (FaxConfigW.ArchiveDirectory)
{
MemFree((PVOID)FaxConfigW.ArchiveDirectory);
}
if (ec != ERROR_SUCCESS)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
}
BOOL
WINAPI
FaxGetLoggingCategoriesA(
IN HANDLE FaxHandle,
OUT PFAX_LOG_CATEGORYA *Categories,
OUT LPDWORD NumberCategories
)
{
BOOL retval;
DWORD i;
DEBUG_FUNCTION_NAME(TEXT("FaxGetLoggingCategoriesA"));
if (!ValidateFaxHandle(FaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!Categories)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("Categories is NULL."));
return FALSE;
}
if (!NumberCategories)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("NumberCategories is NULL."));
return FALSE;
}
retval = FaxGetLoggingCategoriesW(FaxHandle,(PFAX_LOG_CATEGORYW *)Categories , NumberCategories);
if (!retval)
{
DebugPrintEx(DEBUG_ERR, _T("FaxGetLoggingCategoriesW() is failed."));
return FALSE;
}
for (i=0; i<*NumberCategories; i++)
{
if (!ConvertUnicodeStringInPlace((LPWSTR)(*Categories)[i].Name))
{
DebugPrintEx(DEBUG_ERR, _T("ConvertUnicodeStringInPlace failed, ec = %ld."), GetLastError());
MemFree (*Categories);
return FALSE;
}
}
return TRUE;
} // FaxGetLoggingCategoriesA
BOOL
WINAPI
FaxGetLoggingCategoriesW(
IN HANDLE FaxHandle,
OUT PFAX_LOG_CATEGORYW *Categories,
OUT LPDWORD NumberCategories
)
{
error_status_t ec;
DWORD BufferSize = 0;
DWORD i;
DEBUG_FUNCTION_NAME(TEXT("FaxGetLoggingCategoriesW"));
if (!ValidateFaxHandle(FaxHandle,FHT_SERVICE)) {
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!Categories) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("Categories is NULL."));
return FALSE;
}
if (!NumberCategories) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("NumberCategories is NULL."));
return FALSE;
}
*Categories = NULL;
*NumberCategories = 0;
//
__try
{
ec = FAX_GetLoggingCategories(
FH_FAX_HANDLE(FaxHandle),
(LPBYTE*)Categories,
&BufferSize,
NumberCategories
);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_GetLoggingCategories. (ec: %ld)"),
ec);
}
if (ec != ERROR_SUCCESS)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
for (i=0; i<*NumberCategories; i++) {
FixupStringPtrW( Categories, (*Categories)[i].Name );
}
return TRUE;
}
BOOL
WINAPI
FaxSetLoggingCategoriesA(
IN HANDLE FaxHandle,
IN const FAX_LOG_CATEGORYA *Categories,
IN DWORD NumberCategories
)
{
DWORD i;
PFAX_LOG_CATEGORYW CategoryW;
BOOL retval;
DEBUG_FUNCTION_NAME(TEXT("FaxSetLoggingCategoriesA"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(FaxHandle,FHT_SERVICE)) {
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!Categories) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("Categories is NULL."));
return FALSE;
}
if (!NumberCategories) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("NumberCategories is NULL."));
return FALSE;
}
CategoryW = (PFAX_LOG_CATEGORYW) MemAlloc( sizeof(FAX_LOG_CATEGORYW) * NumberCategories );
if (!CategoryW) {
SetLastError(ERROR_NOT_ENOUGH_MEMORY);
DebugPrintEx(DEBUG_ERR, _T("MemAlloc() returned NULL."));
return FALSE;
}
for (i = 0; i< NumberCategories; i++) {
CategoryW[i].Category = Categories[i].Category;
CategoryW[i].Level = Categories[i].Level;
CategoryW[i].Name = (LPCWSTR) AnsiStringToUnicodeString(Categories[i].Name);
if (!CategoryW[i].Name && Categories[i].Name) {
DebugPrintEx(DEBUG_ERR,
_T("AnsiStringToUnicodeString(Categories[%ld].Name) returns NULL."), i);
goto error_exit;
}
}
retval = FaxSetLoggingCategoriesW(FaxHandle, CategoryW, NumberCategories);
for (i = 0; i< NumberCategories; i++) {
if (CategoryW[i].Name) MemFree((LPBYTE)CategoryW[i].Name);
}
MemFree(CategoryW);
return retval;
error_exit:
for (i = 0; i< NumberCategories; i++) {
if (CategoryW[i].Name) MemFree((LPBYTE)CategoryW[i].Name);
}
MemFree(CategoryW);
SetLastError(ERROR_NOT_ENOUGH_MEMORY);
return FALSE;
}
BOOL
WINAPI
FaxSetLoggingCategoriesW(
IN HANDLE FaxHandle,
IN const FAX_LOG_CATEGORYW *Categories,
IN DWORD NumberCategories
)
{
error_status_t ec;
DWORD BufferSize;
DWORD i;
LPBYTE Buffer;
ULONG_PTR Offset;
PFAX_LOG_CATEGORY LogCat;
DEBUG_FUNCTION_NAME(TEXT("FaxSetLoggingCategoriesW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(FaxHandle,FHT_SERVICE)) {
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!Categories) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("Categories is NULL."));
return FALSE;
}
if (!NumberCategories) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("NumberCategories is NULL."));
return FALSE;
}
Offset = sizeof(FAX_LOG_CATEGORY) * NumberCategories;
BufferSize = DWORD(Offset);
for (i=0; i<NumberCategories; i++) {
BufferSize += StringSizeW( Categories[i].Name );
}
Buffer = (LPBYTE) MemAlloc( BufferSize );
if (Buffer == NULL) {
SetLastError( ERROR_NOT_ENOUGH_MEMORY );
DebugPrintEx(DEBUG_ERR, _T("MemAlloc() failed."));
return FALSE;
}
LogCat = (PFAX_LOG_CATEGORY) Buffer;
for (i=0; i<NumberCategories; i++) {
LogCat[i].Category = Categories[i].Category;
LogCat[i].Level = Categories[i].Level;
StoreStringW(
Categories[i].Name,
(PULONG_PTR) &LogCat[i].Name,
Buffer,
&Offset,
BufferSize
);
}
__try
{
ec = FAX_SetLoggingCategories(
FH_FAX_HANDLE(FaxHandle),
Buffer,
BufferSize,
NumberCategories
);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_SetLoggingCategories. (ec: %ld)"),
ec);
}
MemFree( Buffer );
if (ec != ERROR_SUCCESS)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
}
BOOL
WINAPI
FaxGetCountryListW(
IN HANDLE FaxHandle,
OUT PFAX_TAPI_LINECOUNTRY_LISTW *CountryListBuffer
)
{
error_status_t ec;
DWORD dwNumCountries;
DWORD dwIndex;
DEBUG_FUNCTION_NAME(TEXT("FaxGetCountryListW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(FaxHandle, FHT_SERVICE)) {
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!CountryListBuffer) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("CountryListBuffer is NULL."));
return FALSE;
}
*CountryListBuffer = NULL;
dwNumCountries = 0;
//
__try
{
ec = FAX_GetCountryList(
FH_FAX_HANDLE(FaxHandle),
(LPBYTE*)CountryListBuffer,
&dwNumCountries);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_GetCountryList. (ec: %ld)"),
ec);
}
if (ec)
{
DumpRPCExtendedStatus();
SetLastError( ec );
return FALSE;
}
(*CountryListBuffer)->LineCountryEntries =
(PFAX_TAPI_LINECOUNTRY_ENTRYW) ((LPBYTE)*CountryListBuffer +
(ULONG_PTR)(*CountryListBuffer)->LineCountryEntries);
for (dwIndex=0; dwIndex<(*CountryListBuffer)->dwNumCountries; dwIndex++) {
if ((*CountryListBuffer)->LineCountryEntries[dwIndex].lpctstrCountryName) {
(*CountryListBuffer)->LineCountryEntries[dwIndex].lpctstrCountryName =
(LPWSTR) ((LPBYTE)*CountryListBuffer +
(ULONG_PTR)(*CountryListBuffer)->LineCountryEntries[dwIndex].lpctstrCountryName);
}
if ((*CountryListBuffer)->LineCountryEntries[dwIndex].lpctstrLongDistanceRule) {
(*CountryListBuffer)->LineCountryEntries[dwIndex].lpctstrLongDistanceRule =
(LPWSTR) ((LPBYTE)*CountryListBuffer +
(ULONG_PTR)(*CountryListBuffer)->LineCountryEntries[dwIndex].lpctstrLongDistanceRule);
}
}
return TRUE;
}
BOOL
WINAPI
FaxGetCountryListA(
IN HANDLE FaxHandle,
OUT PFAX_TAPI_LINECOUNTRY_LISTA *CountryListBuffer
)
{
DWORD i;
DEBUG_FUNCTION_NAME(TEXT("FaxGetCountryListA"));
//
// no need to validate parameters, FaxGetCountryListW() will do that
//
if (!FaxGetCountryListW( FaxHandle, (PFAX_TAPI_LINECOUNTRY_LISTW*) CountryListBuffer ))
{
DebugPrintEx(DEBUG_ERR, _T("FaxGetCountryListW() is failed. ec = %ld."), GetLastError());
return FALSE;
}
for (i=0; i<(*CountryListBuffer)->dwNumCountries; i++)
{
if (!ConvertUnicodeStringInPlace((LPWSTR)(*CountryListBuffer)->LineCountryEntries[i].lpctstrCountryName) ||
!ConvertUnicodeStringInPlace((LPWSTR)(*CountryListBuffer)->LineCountryEntries[i].lpctstrLongDistanceRule))
{
DebugPrintEx(DEBUG_ERR, _T("ConvertUnicodeStringInPlace failed, ec = %ld."), GetLastError());
MemFree (*CountryListBuffer);
return FALSE;
}
}
return TRUE;
} // FaxGetCountryListA
#ifndef UNICODE
BOOL
WINAPI
FaxGetCountryListX(
IN HANDLE FaxHandle,
OUT PFAX_TAPI_LINECOUNTRY_LISTA *CountryListBuffer
)
{
UNREFERENCED_PARAMETER (FaxHandle);
UNREFERENCED_PARAMETER (CountryListBuffer);
SetLastError (ERROR_CALL_NOT_IMPLEMENTED);
return FALSE;
}
#endif // #ifndef UNICODE
FaxEnumGlobalRoutingInfoW(
IN HANDLE FaxHandle,
OUT PFAX_GLOBAL_ROUTING_INFOW *RoutingInfoBuffer,
OUT LPDWORD MethodsReturned
)
{
PFAX_GLOBAL_ROUTING_INFOW FaxRoutingInfo = NULL;
error_status_t ec;
DWORD i;
DWORD RoutingInfoBufferSize = 0;
DEBUG_FUNCTION_NAME(TEXT("FaxEnumGlobalRoutingInfoW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(FaxHandle,FHT_SERVICE)) {
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!RoutingInfoBuffer) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("RoutingInfoBuffer is NULL."));
return FALSE;
}
if (!MethodsReturned) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("MethodsReturned is NULL."));
return FALSE;
}
*RoutingInfoBuffer = NULL;
__try
{
ec = FAX_EnumGlobalRoutingInfo(
FH_FAX_HANDLE(FaxHandle),
(LPBYTE*)RoutingInfoBuffer,
&RoutingInfoBufferSize,
MethodsReturned
);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_EnumGlobalRoutingInfo. (ec: %ld)"),
ec);
}
if (ec)
{
DumpRPCExtendedStatus();
SetLastError( ec );
return FALSE;
}
FaxRoutingInfo = (PFAX_GLOBAL_ROUTING_INFOW) *RoutingInfoBuffer;
for (i=0; i<*MethodsReturned; i++) {
FixupStringPtrW( RoutingInfoBuffer, FaxRoutingInfo[i].Guid );
FixupStringPtrW( RoutingInfoBuffer, FaxRoutingInfo[i].FunctionName );
FixupStringPtrW( RoutingInfoBuffer, FaxRoutingInfo[i].FriendlyName );
FixupStringPtrW( RoutingInfoBuffer, FaxRoutingInfo[i].ExtensionImageName );
FixupStringPtrW( RoutingInfoBuffer, FaxRoutingInfo[i].ExtensionFriendlyName );
}
return TRUE;
}
BOOL
WINAPI
FaxEnumGlobalRoutingInfoA(
IN HANDLE FaxHandle,
OUT PFAX_GLOBAL_ROUTING_INFOA *RoutingInfoBuffer,
OUT LPDWORD MethodsReturned
)
{
PFAX_GLOBAL_ROUTING_INFOW FaxRoutingMethod = NULL;
DWORD i;
DEBUG_FUNCTION_NAME(TEXT("FaxEnumGlobalRoutingInfoA"));
//
// No need to validate parameters, FaxEnumGlobalRoutingInfoW() will do that
//
if (!FaxEnumGlobalRoutingInfoW(
FaxHandle,
(PFAX_GLOBAL_ROUTING_INFOW *)RoutingInfoBuffer,
MethodsReturned
))
{
DebugPrintEx(DEBUG_ERR, _T("FAX_EnumGlobalRoutingInfoW() failed. ec = %ld."), GetLastError());
return FALSE;
}
FaxRoutingMethod = (PFAX_GLOBAL_ROUTING_INFOW) *RoutingInfoBuffer;
for (i=0; i<*MethodsReturned; i++)
{
if (!ConvertUnicodeStringInPlace((LPWSTR)FaxRoutingMethod[i].Guid) ||
!ConvertUnicodeStringInPlace((LPWSTR)FaxRoutingMethod[i].FunctionName) ||
!ConvertUnicodeStringInPlace((LPWSTR)FaxRoutingMethod[i].FriendlyName) ||
!ConvertUnicodeStringInPlace((LPWSTR)FaxRoutingMethod[i].ExtensionImageName) ||
!ConvertUnicodeStringInPlace((LPWSTR)FaxRoutingMethod[i].ExtensionFriendlyName))
{
DebugPrintEx(DEBUG_ERR, _T("ConvertUnicodeStringInPlace failed, ec = %ld."), GetLastError());
MemFree (*RoutingInfoBuffer);
return FALSE;
}
}
return TRUE;
} // FaxEnumGlobalRoutingInfoA
BOOL
WINAPI
FaxSetGlobalRoutingInfoW(
IN HANDLE FaxHandle,
IN const FAX_GLOBAL_ROUTING_INFOW *RoutingInfo
)
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxSetGlobalRoutingInfoW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(FaxHandle,FHT_SERVICE)) {
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() failed."));
return FALSE;
}
if (!RoutingInfo) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("RoutingInfo is NULL."));
return FALSE;
}
if (RoutingInfo->SizeOfStruct != sizeof(FAX_GLOBAL_ROUTING_INFOW)) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("RoutingInfo->SizeOfStruct != sizeof(FAX_GLOBAL_ROUTING_INFOW)."));
return FALSE;
}
__try
{
ec = FAX_SetGlobalRoutingInfo( FH_FAX_HANDLE(FaxHandle), RoutingInfo );
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_SetGlobalRoutingInfo. (ec: %ld)"),
ec);
}
if (ec)
{
DumpRPCExtendedStatus();
SetLastError( ec );
return FALSE;
}
return TRUE;
}
BOOL
WINAPI
FaxSetGlobalRoutingInfoA(
IN HANDLE FaxHandle,
IN const FAX_GLOBAL_ROUTING_INFOA *RoutingInfo
)
{
BOOL Rval;
FAX_GLOBAL_ROUTING_INFOW RoutingInfoW = {0};
DEBUG_FUNCTION_NAME(TEXT("FaxSetGlobalRoutingInfoA"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(FaxHandle,FHT_SERVICE)) {
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() failed."));
return FALSE;
}
if (!RoutingInfo) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("RoutingInfo is NULL."));
return FALSE;
}
if (RoutingInfo->SizeOfStruct != sizeof(FAX_GLOBAL_ROUTING_INFOA)) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("RoutingInfo->SizeOfStruct != sizeof(FAX_GLOBAL_ROUTING_INFOA)."));
return FALSE;
}
RoutingInfoW.SizeOfStruct = sizeof(FAX_GLOBAL_ROUTING_INFOW);
RoutingInfoW.Priority = RoutingInfo->Priority;
RoutingInfoW.Guid = AnsiStringToUnicodeString(RoutingInfo->Guid);
if (!RoutingInfoW.Guid && RoutingInfo->Guid)
{
Rval = ERROR_OUTOFMEMORY;
DebugPrintEx(DEBUG_ERR,
_T("AnsiStringToUnicodeString(RoutingInfo->Guid) returns NULL."));
goto exit;
}
RoutingInfoW.FriendlyName = AnsiStringToUnicodeString(RoutingInfo->FriendlyName);
if (!RoutingInfoW.FriendlyName && RoutingInfo->FriendlyName)
{
Rval = ERROR_OUTOFMEMORY;
DebugPrintEx(DEBUG_ERR,
_T("AnsiStringToUnicodeString(RoutingInfo->FriendlyName) returns NULL."));
goto exit;
}
RoutingInfoW.FunctionName = AnsiStringToUnicodeString(RoutingInfo->FunctionName);
if (!RoutingInfoW.FunctionName && RoutingInfo->FunctionName)
{
Rval = ERROR_OUTOFMEMORY;
DebugPrintEx(DEBUG_ERR,
_T("AnsiStringToUnicodeString(RoutingInfo->FunctionName) returns NULL."));
goto exit;
}
RoutingInfoW.ExtensionImageName = AnsiStringToUnicodeString(RoutingInfo->ExtensionImageName);
if (!RoutingInfoW.ExtensionImageName && RoutingInfo->ExtensionImageName)
{
Rval = ERROR_OUTOFMEMORY;
DebugPrintEx(DEBUG_ERR,
_T("AnsiStringToUnicodeString(RoutingInfo->ExtensionImageName) returns NULL."));
goto exit;
}
RoutingInfoW.ExtensionFriendlyName = AnsiStringToUnicodeString(RoutingInfo->ExtensionFriendlyName);
if (!RoutingInfoW.ExtensionFriendlyName && RoutingInfo->ExtensionFriendlyName)
{
Rval = ERROR_OUTOFMEMORY;
DebugPrintEx(DEBUG_ERR,
_T("AnsiStringToUnicodeString(RoutingInfo->ExtensionFriendlyName) returns NULL."));
goto exit;
}
Rval = FaxSetGlobalRoutingInfoW( FaxHandle, &RoutingInfoW);
exit:
if (RoutingInfoW.Guid) MemFree( (LPBYTE) RoutingInfoW.Guid ) ;
if (RoutingInfoW.FriendlyName) MemFree( (LPBYTE) RoutingInfoW.FriendlyName ) ;
if (RoutingInfoW.FunctionName) MemFree( (LPBYTE) RoutingInfoW.FunctionName ) ;
if (RoutingInfoW.ExtensionImageName) MemFree( (LPBYTE) RoutingInfoW.ExtensionImageName ) ;
if (RoutingInfoW.ExtensionFriendlyName) MemFree( (LPBYTE) RoutingInfoW.ExtensionFriendlyName ) ;
return Rval;
}
BOOL
WINAPI
FaxAccessCheck(
IN HANDLE FaxHandle,
IN DWORD AccessMask
)
{
BOOL fPermission = FALSE;
error_status_t ec = ERROR_SUCCESS;
DWORD dwAccessMaskEx = 0;
DWORD dwValidMask = (FAX_JOB_SUBMIT |
FAX_JOB_QUERY |
FAX_CONFIG_QUERY |
FAX_CONFIG_SET |
FAX_PORT_QUERY |
FAX_PORT_SET |
FAX_JOB_MANAGE |
WRITE_DAC |
WRITE_OWNER |
ACCESS_SYSTEM_SECURITY |
READ_CONTROL |
GENERIC_ALL |
GENERIC_READ |
GENERIC_WRITE |
GENERIC_EXECUTE);
DEBUG_FUNCTION_NAME(TEXT("FaxAccessCheck"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(FaxHandle,FHT_SERVICE))
{
SetLastError (ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
//
// For legacy support - Turn off SYNCHRONIZE and DELETE (They are part of legacy FAX_ALL_ACCESS)
//
AccessMask &= ~(SYNCHRONIZE | DELETE);
//
// Validate specific access rights
//
if (0 == (AccessMask & dwValidMask))
{
SetLastError( ERROR_SUCCESS ); // // means access is denied
DebugPrintEx(DEBUG_ERR,
_T("AccessMask is invalid - No valid access bit type indicated"));
return FALSE;
}
if ( 0 != (AccessMask & ~dwValidMask))
{
SetLastError( ERROR_SUCCESS ); // means access is denied
DebugPrintEx(DEBUG_ERR,
_T("AccessMask is invalid - contains invalid access type bits"));
return FALSE;
}
//
// Convert the Win2K legacy specific access rights to our new exteneded specific access rights
// before calling FaxAccessCheckEx().
//
if (FAX_JOB_SUBMIT & AccessMask)
{
dwAccessMaskEx |= FAX_ACCESS_SUBMIT;
}
if (FAX_JOB_QUERY & AccessMask)
{
dwAccessMaskEx |= FAX_ACCESS_QUERY_JOBS;
}
if (FAX_CONFIG_QUERY & AccessMask)
{
dwAccessMaskEx |= FAX_ACCESS_QUERY_CONFIG;
}
if (FAX_CONFIG_SET & AccessMask)
{
dwAccessMaskEx |= FAX_ACCESS_MANAGE_CONFIG;
}
if (FAX_PORT_QUERY & AccessMask)
{
dwAccessMaskEx |= FAX_ACCESS_QUERY_CONFIG;
}
if (FAX_PORT_SET & AccessMask)
{
dwAccessMaskEx |= FAX_ACCESS_MANAGE_CONFIG;
}
if (FAX_JOB_MANAGE & AccessMask)
{
dwAccessMaskEx |= FAX_ACCESS_MANAGE_JOBS;
}
//
// Add standard and generic access rights
//
dwAccessMaskEx |= (AccessMask & ~SPECIFIC_RIGHTS_ALL);
return FaxAccessCheckEx (FaxHandle, dwAccessMaskEx, NULL);
}
BOOL
WINAPI
FaxAccessCheckEx(
IN HANDLE hFaxHandle,
IN DWORD dwAccessMask,
IN LPDWORD lpdwAccessRights
)
{
BOOL fPermission = FALSE;
error_status_t ec = ERROR_SUCCESS;
DEBUG_FUNCTION_NAME(TEXT("FaxAccessCheckEx"));
DWORD dwValidMask = ( FAX_ACCESS_SUBMIT |
FAX_ACCESS_SUBMIT_NORMAL |
FAX_ACCESS_SUBMIT_HIGH |
FAX_ACCESS_QUERY_JOBS |
FAX_ACCESS_MANAGE_JOBS |
FAX_ACCESS_QUERY_CONFIG |
FAX_ACCESS_MANAGE_CONFIG |
FAX_ACCESS_QUERY_IN_ARCHIVE |
FAX_ACCESS_MANAGE_IN_ARCHIVE |
FAX_ACCESS_QUERY_OUT_ARCHIVE |
FAX_ACCESS_MANAGE_OUT_ARCHIVE |
WRITE_DAC |
WRITE_OWNER |
ACCESS_SYSTEM_SECURITY |
READ_CONTROL |
MAXIMUM_ALLOWED |
GENERIC_ALL |
GENERIC_READ |
GENERIC_WRITE |
GENERIC_EXECUTE);
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError (ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (0 == (dwAccessMask & dwValidMask))
{
SetLastError( ERROR_SUCCESS ); // means access is denied
DebugPrintEx(DEBUG_ERR,
_T("dwAccessMask is invalid - No valid access bit type indicated"));
return FALSE;
}
if ( 0 != (dwAccessMask & ~dwValidMask))
{
SetLastError( ERROR_SUCCESS ); // means access is denied
DebugPrintEx(DEBUG_ERR,
_T("dwAccessMask is invalid - contains invalid access type bits"));
return FALSE;
}
__try
{
ec = FAX_AccessCheck( FH_FAX_HANDLE(hFaxHandle), dwAccessMask, &fPermission, lpdwAccessRights);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we crashed.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_AccessCheck. (ec: %ld)"),
ec);
}
if (ec != ERROR_SUCCESS)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
SetLastError (ERROR_SUCCESS);
return fPermission;
}
//************************************
//* Getting / Setting the queue state
//************************************
BOOL
WINAPI
FaxGetQueueStates (
IN HANDLE hFaxHandle,
OUT PDWORD pdwQueueStates
)
/*++
Routine name : FaxGetQueueStates
Routine description:
Retruns the state of the queue
Author:
Eran Yariv (EranY), Nov, 1999
Arguments:
hFaxHandle [in] - Handle to fax server
pdwQueueStates [out] - Returned queue state
Return Value:
TRUE on success, FALSE otherwise
--*/
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxGetQueueStates"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (NULL == pdwQueueStates)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pdwQueueStates is NULL."));
return FALSE;
}
__try
{
ec = FAX_GetQueueStates(
FH_FAX_HANDLE(hFaxHandle),
pdwQueueStates
);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we crashed.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_GetQueueStates. (ec: %ld)"),
ec);
}
if (ec != ERROR_SUCCESS)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
} // FaxGetQueueStates
BOOL
WINAPI
FaxSetQueue (
IN HANDLE hFaxHandle,
IN CONST DWORD dwQueueStates
)
/*++
Routine name : FaxSetQueue
Routine description:
Sets the server's queue state
Author:
Eran Yariv (EranY), Nov, 1999
Arguments:
hFaxHandle [in] - Handle to fax server
dwQueueStates [in] - New queue state
Return Value:
TRUE on success, FALSE otherwise
--*/
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxSetQueue"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (dwQueueStates & ~(FAX_INCOMING_BLOCKED | FAX_OUTBOX_BLOCKED | FAX_OUTBOX_PAUSED))
{
//
// Some invalid queue state specified
//
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("Invalid dwQueueStates."));
return FALSE;
}
__try
{
ec = FAX_SetQueue(
FH_FAX_HANDLE(hFaxHandle),
dwQueueStates
);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we crashed.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_SetQueue. (ec: %ld)"),
ec);
}
if (ec != ERROR_SUCCESS)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
} // FaxSetQueue
//************************************************
//* Getting / Setting the receipts configuration
//************************************************
BOOL
WINAPI
FaxGetReceiptsConfigurationA (
IN HANDLE hFaxHandle,
OUT PFAX_RECEIPTS_CONFIGA *ppReceipts
)
/*++
Routine name : FaxGetReceiptsConfigurationA
Routine description:
Retrieve receipts configuration - ANSI version
Author:
Eran Yariv (EranY), Nov, 1999
Arguments:
hFaxHandle [in ] - Fax server handle
ppReceipts [out] - New receipts configuration buffer
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
DEBUG_FUNCTION_NAME(TEXT("FaxGetReceiptsConfigurationA"));
//
// no need to validate parameters ,FaxGetReceipsConfigurationW() will do that
//
if (!FaxGetReceiptsConfigurationW(
hFaxHandle,
(PFAX_RECEIPTS_CONFIGW*) ppReceipts
))
{
DebugPrintEx(DEBUG_ERR, _T("FaxGetReceiptsConfigurationW() is failed. ec = %ld."), GetLastError());
return FALSE;
}
if (!ConvertUnicodeStringInPlace((LPWSTR) (*ppReceipts)->lptstrSMTPServer) ||
!ConvertUnicodeStringInPlace((LPWSTR) (*ppReceipts)->lptstrSMTPFrom) ||
!ConvertUnicodeStringInPlace((LPWSTR) (*ppReceipts)->lptstrSMTPUserName) ||
!ConvertUnicodeStringInPlace((LPWSTR) (*ppReceipts)->lptstrSMTPPassword))
{
DebugPrintEx(DEBUG_ERR, _T("ConvertUnicodeStringInPlace failed, ec = %ld."), GetLastError());
MemFree (*ppReceipts);
return FALSE;
}
return TRUE;
} // FaxGetReceiptsConfigurationA
BOOL
WINAPI
FaxGetReceiptsConfigurationW (
IN HANDLE hFaxHandle,
OUT PFAX_RECEIPTS_CONFIGW *ppReceipts
)
/*++
Routine name : FaxGetReceiptsConfigurationW
Routine description:
Retrieve receipts configuration - Unicode version
Author:
Eran Yariv (EranY), Nov, 1999
Arguments:
hFaxHandle [in ] - Fax server handle
ppReceipts [out] - New receipts configuration buffer
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DWORD dwConfigSize = 0;
DEBUG_FUNCTION_NAME(TEXT("FaxGetReceiptsConfigurationW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!ppReceipts)
{
SetLastError( ERROR_INVALID_PARAMETER );
DebugPrintEx(DEBUG_ERR, _T("ppReceipts is NULL."));
return FALSE;
}
*ppReceipts = NULL;
__try
{
ec = FAX_GetReceiptsConfiguration (
FH_FAX_HANDLE(hFaxHandle),
(LPBYTE*)ppReceipts,
&dwConfigSize
);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_GetReceiptsConfiguration. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError( ec );
return FALSE;
}
FixupStringPtrW( ppReceipts, (*ppReceipts)->lptstrSMTPServer );
FixupStringPtrW( ppReceipts, (*ppReceipts)->lptstrSMTPFrom );
FixupStringPtrW( ppReceipts, (*ppReceipts)->lptstrSMTPUserName );
FixupStringPtrW( ppReceipts, (*ppReceipts)->lptstrSMTPPassword );
return TRUE;
} // FaxGetReceiptsConfigurationW
#ifndef UNICODE
BOOL
WINAPI
FaxGetReceiptsConfigurationX (
IN HANDLE hFaxHandle,
OUT PFAX_RECEIPTS_CONFIGW *ppReceipts
)
{
UNREFERENCED_PARAMETER (hFaxHandle);
UNREFERENCED_PARAMETER (ppReceipts);
SetLastError (ERROR_CALL_NOT_IMPLEMENTED);
return FALSE;
}
#endif // #ifndef UNICODE
BOOL
WINAPI
FaxSetReceiptsConfigurationA (
IN HANDLE hFaxHandle,
IN CONST PFAX_RECEIPTS_CONFIGA pReceipts
)
/*++
Routine name : FaxSetReceiptsConfigurationA
Routine description:
Set receipts configuration - ANSI version
Author:
Eran Yariv (EranY), Nov, 1999
Arguments:
hFaxHandle [in] - Handle to fax server
pReceipts [in] - New configuration
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
FAX_RECEIPTS_CONFIGW ReceiptsConfigW;
BOOL bRes = FALSE;
DEBUG_FUNCTION_NAME(TEXT("FaxSetReceiptsConfigurationA"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!pReceipts)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pReceipts is NULL."));
return FALSE;
}
if (sizeof (FAX_RECEIPTS_CONFIGA) != pReceipts->dwSizeOfStruct)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("sizeof (FAX_RECEIPTS_CONFIGA) != pReceipts->dwSizeOfStruct"));
return FALSE;
}
//
// ansi structure is same size as unicode structure, so we can just copy it, then
// cast the string pointers correctly
//
CopyMemory(&ReceiptsConfigW, pReceipts, sizeof(FAX_RECEIPTS_CONFIGA));
ReceiptsConfigW.dwSizeOfStruct = sizeof (FAX_RECEIPTS_CONFIGW);
ReceiptsConfigW.bIsToUseForMSRouteThroughEmailMethod = pReceipts->bIsToUseForMSRouteThroughEmailMethod;
ReceiptsConfigW.lptstrSMTPFrom = NULL;
ReceiptsConfigW.lptstrSMTPUserName = NULL;
ReceiptsConfigW.lptstrSMTPPassword = NULL;
ReceiptsConfigW.lptstrSMTPServer = NULL;
ReceiptsConfigW.lptstrReserved = NULL;
if (pReceipts->lptstrSMTPServer)
{
if (NULL ==
(ReceiptsConfigW.lptstrSMTPServer = AnsiStringToUnicodeString(pReceipts->lptstrSMTPServer))
)
{
DebugPrintEx(DEBUG_ERR,
_T("AnsiStringToUnicodeString(pReceipts->lptstrSMTPServer) returns NULL."));
goto exit;
}
}
if (pReceipts->lptstrSMTPFrom)
{
if (NULL ==
(ReceiptsConfigW.lptstrSMTPFrom = AnsiStringToUnicodeString(pReceipts->lptstrSMTPFrom))
)
{
DebugPrintEx(DEBUG_ERR,
_T("AnsiStringToUnicodeString(pReceipts->lptstrSMTPFrom) returns NULL."));
goto exit;
}
}
if (pReceipts->lptstrSMTPUserName)
{
if (NULL ==
(ReceiptsConfigW.lptstrSMTPUserName = AnsiStringToUnicodeString(pReceipts->lptstrSMTPUserName))
)
{
DebugPrintEx(DEBUG_ERR,
_T("AnsiStringToUnicodeString(pReceipts->lptstrSMTPUserName) returns NULL."));
goto exit;
}
}
if (pReceipts->lptstrSMTPPassword)
{
if (NULL ==
(ReceiptsConfigW.lptstrSMTPPassword = AnsiStringToUnicodeString(pReceipts->lptstrSMTPPassword))
)
{
DebugPrintEx(DEBUG_ERR,
_T("AnsiStringToUnicodeString(pReceipts->lptstrSMTPPassword) returns NULL."));
goto exit;
}
}
bRes = FaxSetReceiptsConfigurationW (hFaxHandle, &ReceiptsConfigW);
exit:
MemFree((PVOID)ReceiptsConfigW.lptstrSMTPServer);
MemFree((PVOID)ReceiptsConfigW.lptstrSMTPFrom);
MemFree((PVOID)ReceiptsConfigW.lptstrSMTPUserName);
SecureZeroMemory((PVOID)ReceiptsConfigW.lptstrSMTPPassword,wcslen(ReceiptsConfigW.lptstrSMTPPassword)*sizeof(WCHAR));
MemFree((PVOID)ReceiptsConfigW.lptstrSMTPPassword);
return bRes;
} // FaxSetReceiptsConfigurationA
BOOL
WINAPI
FaxSetReceiptsConfigurationW (
IN HANDLE hFaxHandle,
IN CONST PFAX_RECEIPTS_CONFIGW pReceipts
)
/*++
Routine name : FaxSetReceiptsConfigurationW
Routine description:
Set receipts configuration - UNICODE version
Author:
Eran Yariv (EranY), Nov, 1999
Arguments:
hFaxHandle [in] - Handle to fax server
pReceipts [in] - New configuration
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxSetReceiptsConfigurationW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!pReceipts)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pReceipts is NULL."));
return FALSE;
}
if (sizeof (FAX_RECEIPTS_CONFIGW) != pReceipts->dwSizeOfStruct)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("sizeof (FAX_RECEIPTS_CONFIGW) != pReceipts->dwSizeOfStruct"));
return FALSE;
}
if ((pReceipts->SMTPAuthOption < FAX_SMTP_AUTH_ANONYMOUS) ||
(pReceipts->SMTPAuthOption > FAX_SMTP_AUTH_NTLM))
{
//
// SMTP auth type type is invalid
//
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("SMTP auth type is invalid."));
return FALSE;
}
if ((pReceipts->dwAllowedReceipts) & ~DRT_ALL)
{
//
// Receipts type is invalid
//
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR,
_T("Receipts type is invalid : (pReceipts->dwAllowedReceipts) & ~DRT_ALL."));
return FALSE;
}
__try
{
ec = FAX_SetReceiptsConfiguration(
FH_FAX_HANDLE(hFaxHandle),
pReceipts );
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_SetReceiptsConfiguration. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
} // FaxSetReceiptsConfigurationW
#ifndef UNICODE
BOOL
WINAPI
FaxSetReceiptsConfigurationX (
IN HANDLE hFaxHandle,
IN CONST PFAX_RECEIPTS_CONFIGW pReceipts
)
{
UNREFERENCED_PARAMETER (hFaxHandle);
UNREFERENCED_PARAMETER (pReceipts);
SetLastError (ERROR_CALL_NOT_IMPLEMENTED);
return FALSE;
}
#endif // #ifndef UNICODE
//********************************************
//* Server version
//********************************************
BOOL
WINAPI
FaxGetVersion (
IN HANDLE hFaxHandle,
OUT PFAX_VERSION pVersion
)
/*++
Routine name : FaxGetVersion
Routine description:
Retrieves the version of the fax server
Author:
Eran Yariv (EranY), Nov, 1999
Arguments:
hFaxHandle [in ] - Handle to fax server
pVersion [in\out] - Returned version structure
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxGetVersion"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!pVersion)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pVersion is NULL."));
return FALSE;
}
if (sizeof (FAX_VERSION) != pVersion->dwSizeOfStruct)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("sizeof (FAX_VERSION) != pVersion->dwSizeOfStruct."));
return FALSE;
}
__try
{
ec = FAX_GetVersion(
FH_FAX_HANDLE(hFaxHandle),
pVersion );
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_GetVersion. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
} // FaxGetVersion
//********************************************
//* Outbox configuration
//********************************************
BOOL
WINAPI
FaxGetOutboxConfiguration (
IN HANDLE hFaxHandle,
OUT PFAX_OUTBOX_CONFIG *ppOutboxCfg
)
/*++
Routine name : FaxGetOutboxConfiguration
Routine description:
Get Outbox configuration
Author:
Eran Yariv (EranY), Nov, 1999
Arguments:
hFaxHandle [in ] - Handle to fax server
ppOutboxCfg [out] - New Outbox configuration buffer
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DWORD dwConfigSize = 0;
DEBUG_FUNCTION_NAME(TEXT("FaxGetOutboxConfiguration"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!ppOutboxCfg)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("ppOutboxCfg is NULL."));
return FALSE;
}
*ppOutboxCfg = NULL;
__try
{
ec = FAX_GetOutboxConfiguration(
FH_FAX_HANDLE(hFaxHandle),
(LPBYTE*)ppOutboxCfg,
&dwConfigSize
);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_GetOutboxConfiguration. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
} // FaxGetOutboxConfiguration
BOOL
WINAPI
FaxSetOutboxConfiguration (
IN HANDLE hFaxHandle,
IN CONST PFAX_OUTBOX_CONFIG pOutboxCfg
)
/*++
Routine name : FaxSetOutboxConfiguration
Routine description:
Set Outbox configuration
Author:
Eran Yariv (EranY), Nov, 1999
Arguments:
hFaxHandle [in] - Handle to fax server
pOutboxCfg [in] - New configuration
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxSetOutboxConfiguration"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!pOutboxCfg)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pOutboxCfg is NULL."));
return FALSE;
}
if (sizeof (FAX_OUTBOX_CONFIG) != pOutboxCfg->dwSizeOfStruct)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("sizeof (FAX_OUTBOX_CONFIG) != pOutboxCfg->dwSizeOfStruct."));
return FALSE;
}
if ((pOutboxCfg->dtDiscountStart.Hour > 23) ||
(pOutboxCfg->dtDiscountStart.Minute > 59) ||
(pOutboxCfg->dtDiscountEnd.Hour > 23) ||
(pOutboxCfg->dtDiscountEnd.Minute > 59))
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("wrong pOutboxCfg->dwDiscountStart OR ->dwDiscountEnd."));
return FALSE;
}
__try
{
ec = FAX_SetOutboxConfiguration(
FH_FAX_HANDLE(hFaxHandle),
pOutboxCfg );
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_SetOutboxConfiguration. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
} // FaxSetOutboxConfiguration
//********************************************
//* Archive configuration
//********************************************
BOOL
WINAPI
FaxGetArchiveConfigurationA (
IN HANDLE hFaxHandle,
IN FAX_ENUM_MESSAGE_FOLDER Folder,
OUT PFAX_ARCHIVE_CONFIGA *ppArchiveCfg
)
/*++
Routine name : FaxGetArchiveConfigurationA
Routine description:
Gets the archive configuration - ANSI version
Author:
Eran Yariv (EranY), Nov, 1999
Arguments:
hFaxHandle [in ] - Handle to fax server
Folder [in ] - Folder type
ppArchiveCfg [out] - Configuration buffer
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
DEBUG_FUNCTION_NAME(TEXT("FaxGetArchiveConfigurationA"));
//
// no need to validate parameters, FaxGetArchiveConfigurationW() will do that
//
if (!FaxGetArchiveConfigurationW(
hFaxHandle,
Folder,
(PFAX_ARCHIVE_CONFIGW*) ppArchiveCfg
))
{
DebugPrintEx(DEBUG_ERR, _T("FaxGetArchiveConfigurationW() is failed."));
return FALSE;
}
if (!ConvertUnicodeStringInPlace((LPWSTR)(*ppArchiveCfg)->lpcstrFolder))
{
DebugPrintEx(DEBUG_ERR, _T("ConvertUnicodeStringInPlace failed, ec = %ld."), GetLastError());
MemFree (*ppArchiveCfg);
return FALSE;
}
(*ppArchiveCfg)->dwSizeOfStruct = sizeof(FAX_ARCHIVE_CONFIGA);
return TRUE;
} // FaxGetArchiveConfigurationA
BOOL
WINAPI
FaxGetArchiveConfigurationW (
IN HANDLE hFaxHandle,
IN FAX_ENUM_MESSAGE_FOLDER Folder,
OUT PFAX_ARCHIVE_CONFIGW *ppArchiveCfg
)
/*++
Routine name : FaxGetArchiveConfigurationW
Routine description:
Gets the archive configuration - UNICODE version
Author:
Eran Yariv (EranY), Nov, 1999
Arguments:
hFaxHandle [in ] - Handle to fax server
Folder [in ] - Folder type
ppArchiveCfg [out] - Configuration buffer
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
DWORD dwConfigSize = 0;
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxGetArchiveConfigurationA"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!ppArchiveCfg)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("ppArchiveCfg is NULL."));
return FALSE;
}
if ((Folder != FAX_MESSAGE_FOLDER_SENTITEMS) &&
(Folder != FAX_MESSAGE_FOLDER_INBOX)
)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("Folder is neither SentItems nor Inbox."));
return FALSE;
}
*ppArchiveCfg = NULL;
__try
{
ec = FAX_GetArchiveConfiguration(
FH_FAX_HANDLE(hFaxHandle),
Folder,
(LPBYTE*)ppArchiveCfg,
&dwConfigSize
);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_GetArchiveConfiguration. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
FixupStringPtrW( ppArchiveCfg, (*ppArchiveCfg)->lpcstrFolder );
return TRUE;
} // FaxGetArchiveConfigurationW
#ifndef UNICODE
FaxGetArchiveConfigurationX (
IN HANDLE hFaxHandle,
IN FAX_ENUM_MESSAGE_FOLDER Folder,
OUT PFAX_ARCHIVE_CONFIGW *ppArchiveCfg
)
{
UNREFERENCED_PARAMETER (hFaxHandle);
UNREFERENCED_PARAMETER (Folder);
UNREFERENCED_PARAMETER (ppArchiveCfg);
SetLastError (ERROR_CALL_NOT_IMPLEMENTED);
return FALSE;
}
#endif // #ifndef UNICODE
BOOL
WINAPI
FaxSetArchiveConfigurationA (
IN HANDLE hFaxHandle,
IN FAX_ENUM_MESSAGE_FOLDER Folder,
IN CONST PFAX_ARCHIVE_CONFIGA pArchiveCfg
)
/*++
Routine name : FaxSetArchiveConfigurationA
Routine description:
Sets the archive configuration - ANSI version
Author:
Eran Yariv (EranY), Nov, 1999
Arguments:
hFaxHandle [in ] - Handle to fax server
Folder [in ] - Folder type
pArchiveCfg [in ] - New configuration.
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
FAX_ARCHIVE_CONFIGW ConfigW;
BOOL bRes;
DEBUG_FUNCTION_NAME(TEXT("FaxSetArchiveConfigurationA"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle is failed."));
return FALSE;
}
if (!pArchiveCfg)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pArchiveCfg is NULL."));
return FALSE;
}
if (sizeof(FAX_ARCHIVE_CONFIGA) != pArchiveCfg->dwSizeOfStruct)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pArchiveCfg->dwSizeOfStruct != sizeof(FAX_ARCHIVE_CONFIGA)."));
return FALSE;
}
//
// Create a UNICODE structure and pass along to UNICODE function
// Ansi structure is same size as unicode structure, so we can just copy it, then
// cast the string pointers correctly
//
CopyMemory(&ConfigW, pArchiveCfg, sizeof(FAX_ARCHIVE_CONFIGA));
ConfigW.lpcstrFolder = NULL;
ConfigW.dwSizeOfStruct = sizeof (FAX_ARCHIVE_CONFIGW);
if (pArchiveCfg->lpcstrFolder)
{
if (NULL ==
(ConfigW.lpcstrFolder = AnsiStringToUnicodeString(pArchiveCfg->lpcstrFolder))
)
{
DebugPrintEx(DEBUG_ERR,
_T("AnsiStringToUnicodeString(pArchiveCfg->lpcstrFolder) returns NULL."));
return FALSE;
}
}
bRes = FaxSetArchiveConfigurationW (hFaxHandle, Folder, &ConfigW);
MemFree((PVOID)ConfigW.lpcstrFolder);
return bRes;
} // FaxSetArchiveConfigurationA
BOOL
WINAPI
FaxSetArchiveConfigurationW (
IN HANDLE hFaxHandle,
IN FAX_ENUM_MESSAGE_FOLDER Folder,
IN CONST PFAX_ARCHIVE_CONFIGW pArchiveCfg
)
/*++
Routine name : FaxSetArchiveConfigurationW
Routine description:
Sets the archive configuration - UNICODE version
Author:
Eran Yariv (EranY), Nov, 1999
Arguments:
hFaxHandle [in ] - Handle to fax server
Folder [in ] - Folder type
pArchiveCfg [in ] - New configuration.
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxSetArchiveConfigurationW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!pArchiveCfg)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pArchiveCfg is NULL."));
return FALSE;
}
if ((Folder != FAX_MESSAGE_FOLDER_SENTITEMS) &&
(Folder != FAX_MESSAGE_FOLDER_INBOX)
)
{
DebugPrintEx(DEBUG_ERR, _T("Invalid folder id (%ld)"), Folder);
SetLastError(ERROR_INVALID_PARAMETER);
return FALSE;
}
if (sizeof(FAX_ARCHIVE_CONFIGW) != pArchiveCfg->dwSizeOfStruct)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("sizeof(FAX_ARCHIVE_CONFIGW) != pArchiveCfg->dwSizeOfStruct."));
return FALSE;
}
if (pArchiveCfg->bUseArchive)
{
if (pArchiveCfg->dwSizeQuotaHighWatermark < pArchiveCfg->dwSizeQuotaLowWatermark)
{
DebugPrintEx(DEBUG_ERR,
_T("Watermarks mismatch (high=%ld, low=%ld)"),
pArchiveCfg->dwSizeQuotaHighWatermark,
pArchiveCfg->dwSizeQuotaLowWatermark);
SetLastError(ERROR_INVALID_PARAMETER);
return FALSE;
}
if ((NULL == pArchiveCfg->lpcstrFolder) || (L'\0' == pArchiveCfg->lpcstrFolder[0]))
{
DebugPrintEx(DEBUG_ERR, _T("Empty archive folder specified"));
SetLastError(ERROR_INVALID_PARAMETER);
return FALSE;
}
if (lstrlenW (pArchiveCfg->lpcstrFolder) > MAX_ARCHIVE_FOLDER_PATH)
{
DebugPrintEx(DEBUG_ERR, _T("DB file name exceeds MAX_PATH"));
SetLastError (ERROR_BUFFER_OVERFLOW);
return FALSE;
}
}
__try
{
ec = FAX_SetArchiveConfiguration(
FH_FAX_HANDLE(hFaxHandle),
Folder,
pArchiveCfg );
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_SetArchiveConfiguration. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
} // FaxSetArchiveConfigurationW
#ifndef UNICODE
FaxSetArchiveConfigurationX (
IN HANDLE hFaxHandle,
IN FAX_ENUM_MESSAGE_FOLDER Folder,
IN CONST PFAX_ARCHIVE_CONFIGW pArchiveCfg
)
{
UNREFERENCED_PARAMETER (hFaxHandle);
UNREFERENCED_PARAMETER (Folder);
UNREFERENCED_PARAMETER (pArchiveCfg);
SetLastError (ERROR_CALL_NOT_IMPLEMENTED);
return FALSE;
}
#endif // #ifndef UNICODE
//********************************************
//* Activity logging
//********************************************
BOOL
WINAPI
FaxGetActivityLoggingConfigurationA (
IN HANDLE hFaxHandle,
OUT PFAX_ACTIVITY_LOGGING_CONFIGA *ppLoggingCfg
)
/*++
Routine name : FaxGetActivityLoggingConfigurationA
Routine description:
Gets the activity logging configuration - ANSI version
Author:
Eran Yariv (EranY), Nov, 1999
Arguments:
hFaxHandle [in ] - Handle to fax server
ppLoggingCfg [out] - Configuration buffer
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
DEBUG_FUNCTION_NAME(TEXT("FaxGetActivityLoggingConfigurationA"));
//
// no need to validate parameters, FaxGetActivityLoggingConfigurationW() will do that
//
if (!FaxGetActivityLoggingConfigurationW(
hFaxHandle,
(PFAX_ACTIVITY_LOGGING_CONFIGW*) ppLoggingCfg
))
{
DebugPrintEx(DEBUG_ERR, _T("FaxGetActivityLoggingConfigurationW() is failed."));
return FALSE;
}
if (!ConvertUnicodeStringInPlace((LPWSTR) (*ppLoggingCfg)->lptstrDBPath))
{
DebugPrintEx(DEBUG_ERR, _T("ConvertUnicodeStringInPlace failed, ec = %ld."), GetLastError());
MemFree (*ppLoggingCfg);
return FALSE;
}
(*ppLoggingCfg)->dwSizeOfStruct = sizeof(FAX_ACTIVITY_LOGGING_CONFIGA);
return TRUE;
} // FaxGetActivityLoggingConfigurationA
BOOL
WINAPI
FaxGetActivityLoggingConfigurationW (
IN HANDLE hFaxHandle,
OUT PFAX_ACTIVITY_LOGGING_CONFIGW *ppLoggingCfg
)
/*++
Routine name : FaxGetActivityLoggingConfigurationW
Routine description:
Gets the activity logging configuration - UNICODE version
Author:
Eran Yariv (EranY), Nov, 1999
Arguments:
hFaxHandle [in ] - Handle to fax server
ppLoggingCfg [out] - Configuration buffer
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
DWORD dwConfigSize = 0;
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxGetActivityLoggingConfigurationW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!ppLoggingCfg)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("ppLoggingCfg is NULL."));
return FALSE;
}
*ppLoggingCfg = NULL;
__try
{
ec = FAX_GetActivityLoggingConfiguration(
FH_FAX_HANDLE(hFaxHandle),
(LPBYTE*)ppLoggingCfg,
&dwConfigSize
);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_GetActivityLoggingConfiguration. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
FixupStringPtrW( ppLoggingCfg, (*ppLoggingCfg)->lptstrDBPath );
return TRUE;
} // FaxGetActivityLoggingConfigurationW
#ifndef UNICODE
FaxGetActivityLoggingConfigurationX (
IN HANDLE hFaxHandle,
OUT PFAX_ACTIVITY_LOGGING_CONFIGW *ppLoggingCfg
)
{
UNREFERENCED_PARAMETER (hFaxHandle);
UNREFERENCED_PARAMETER (ppLoggingCfg);
SetLastError (ERROR_CALL_NOT_IMPLEMENTED);
return FALSE;
} // FaxGetActivityLoggingConfigurationX
#endif // #ifndef UNICODE
BOOL
WINAPI
FaxSetActivityLoggingConfigurationA (
IN HANDLE hFaxHandle,
IN CONST PFAX_ACTIVITY_LOGGING_CONFIGA pLoggingCfg
)
/*++
Routine name : FaxSetActivityLoggingConfigurationA
Routine description:
Sets the activity logging configuration - ANSI version
Author:
Eran Yariv (EranY), Nov, 1999
Arguments:
hFaxHandle [in ] - Handle to fax server
pLoggingCfg [in ] - New configuration
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
FAX_ACTIVITY_LOGGING_CONFIGW ConfigW;
BOOL bRes;
DEBUG_FUNCTION_NAME(TEXT("FaxSetActivityLoggingConfigurationA"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!pLoggingCfg)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pLoggingCfg is NULL."));
return FALSE;
}
if (sizeof (FAX_ACTIVITY_LOGGING_CONFIGA) != pLoggingCfg->dwSizeOfStruct)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR,
_T("sizeof (FAX_ACTIVITY_LOGGING_CONFIGA) != pLoggingCfg->dwSizeOfStruct."));
return FALSE;
}
//
// Create a UNICODE structure and pass along to UNICODE function
// Ansi structure is same size as unicode structure, so we can just copy it, then
// cast the string pointers correctly
//
CopyMemory(&ConfigW, pLoggingCfg, sizeof(FAX_ACTIVITY_LOGGING_CONFIGA));
ConfigW.lptstrDBPath = NULL;
ConfigW.dwSizeOfStruct = sizeof (FAX_ACTIVITY_LOGGING_CONFIGW);
if (pLoggingCfg->lptstrDBPath)
{
if (NULL ==
(ConfigW.lptstrDBPath = AnsiStringToUnicodeString(pLoggingCfg->lptstrDBPath))
)
{
DebugPrintEx(DEBUG_ERR,
_T("AnsiStringToUnicodeString(pLoggingCfg->lptstrDBPath) returns NULL."));
return FALSE;
}
}
bRes = FaxSetActivityLoggingConfigurationW (hFaxHandle, &ConfigW);
MemFree((PVOID)ConfigW.lptstrDBPath);
return bRes;
} // FaxSetActivityLoggingConfigurationA
BOOL
WINAPI
FaxSetActivityLoggingConfigurationW (
IN HANDLE hFaxHandle,
IN CONST PFAX_ACTIVITY_LOGGING_CONFIGW pLoggingCfg
)
/*++
Routine name : FaxSetActivityLoggingConfigurationW
Routine description:
Sets the activity logging configuration - UNICODE version
Author:
Eran Yariv (EranY), Nov, 1999
Arguments:
hFaxHandle [in ] - Handle to fax server
pLoggingCfg [in ] - New configuration
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxSetActivityLoggingConfigurationW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!pLoggingCfg)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pLoggingCfg is NULL."));
return FALSE;
}
if (sizeof (FAX_ACTIVITY_LOGGING_CONFIGW) != pLoggingCfg->dwSizeOfStruct)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR,
_T("sizeof (FAX_ACTIVITY_LOGGING_CONFIGW) != pLoggingCfg->dwSizeOfStruct."));
return FALSE;
}
if (pLoggingCfg->bLogIncoming || pLoggingCfg->bLogOutgoing)
{
if ((NULL == pLoggingCfg->lptstrDBPath) || (L'\0' == pLoggingCfg->lptstrDBPath[0]))
{
DebugPrintEx(DEBUG_ERR, _T("Empty logging database specified"));
SetLastError(ERROR_INVALID_PARAMETER);
return FALSE;
}
if (lstrlenW (pLoggingCfg->lptstrDBPath) > MAX_DIR_PATH) // Limit of directory path length
{
DebugPrintEx(DEBUG_ERR, _T("DB file name exceeds MAX_PATH"));
SetLastError (ERROR_BUFFER_OVERFLOW);
return FALSE;
}
}
__try
{
ec = FAX_SetActivityLoggingConfiguration(
FH_FAX_HANDLE(hFaxHandle),
pLoggingCfg );
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_SetActivityLoggingConfiguration. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
} // FaxSetActivityLoggingConfigurationW
#ifndef UNICODE
FaxSetActivityLoggingConfigurationX (
IN HANDLE hFaxHandle,
IN CONST PFAX_ACTIVITY_LOGGING_CONFIGW pLoggingCfg
)
{
UNREFERENCED_PARAMETER (hFaxHandle);
UNREFERENCED_PARAMETER (pLoggingCfg);
SetLastError (ERROR_CALL_NOT_IMPLEMENTED);
return FALSE;
} // FaxSetActivityLoggingConfigurationX
#endif // #ifndef UNICODE
//********************************************
//* Outbound routing
//********************************************
BOOL
WINAPI
FaxAddOutboundGroupA (
IN HANDLE hFaxHandle,
IN LPCSTR lpctstrGroupName
)
{
LPWSTR lpwstrGroupName;
BOOL bRes;
DEBUG_FUNCTION_NAME(TEXT("FaxAddOutboundGroupA"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!lpctstrGroupName)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("lpctstrGroupName is NULL."));
return FALSE;
}
if (_mbsicmp((PUCHAR)lpctstrGroupName, (PUCHAR)ROUTING_GROUP_ALL_DEVICESA) == 0)
{
SetLastError(ERROR_DUP_NAME);
DebugPrintEx(DEBUG_ERR,
_T("_mbsicmp((PUCHAR)lpctstrGroupName, (PUCHAR)ROUTING_GROUP_ALL_DEVICESA) == 0."));
return FALSE;
}
if (strlen(lpctstrGroupName) >= MAX_ROUTING_GROUP_NAME)
{
SetLastError(ERROR_BUFFER_OVERFLOW);
DebugPrintEx(DEBUG_ERR, _T("strlen(lpctstrGroupName) >= MAX_ROUTING_GROUP_NAME."));
return FALSE;
}
if (NULL == (lpwstrGroupName = AnsiStringToUnicodeString(lpctstrGroupName)))
{
DebugPrintEx(
DEBUG_ERR,
TEXT("AnsiStringToUnicodeString failed. (ec: %ld)"),
GetLastError());
return FALSE;
}
bRes = FaxAddOutboundGroupW (hFaxHandle, lpwstrGroupName);
MemFree (lpwstrGroupName);
return bRes;
}
BOOL
WINAPI
FaxAddOutboundGroupW (
IN HANDLE hFaxHandle,
IN LPCWSTR lpctstrGroupName
)
/*++
Routine name : FaxAddOutboundGroupW
Routine description:
Adds an empty outbound routing group for a Fax server
Author:
Oded Sacher (OdedS), Nov, 1999
Arguments:
hFaxHandle [ in ] - Fax server handle obtained from a call to FaxConnectFaxServer
lpctstrGroupName [ in ] - A pointer to a null-terminated string that uniqely identifies a new group name
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxAddOutboundGroupW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!lpctstrGroupName)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("lpctstrGroupName is NULL."));
return FALSE;
}
if (_wcsicmp (lpctstrGroupName, ROUTING_GROUP_ALL_DEVICESW) == 0)
{
SetLastError(ERROR_DUP_NAME);
DebugPrintEx(DEBUG_ERR,
_T("_mbsicmp((PUCHAR)lpctstrGroupName, (PUCHAR)ROUTING_GROUP_ALL_DEVICESA) == 0."));
return FALSE;
}
if (wcslen (lpctstrGroupName) >= MAX_ROUTING_GROUP_NAME)
{
SetLastError(ERROR_BUFFER_OVERFLOW);
DebugPrintEx(DEBUG_ERR, _T("strlen(lpctstrGroupName) >= MAX_ROUTING_GROUP_NAME."));
return FALSE;
}
__try
{
ec = FAX_AddOutboundGroup( FH_FAX_HANDLE(hFaxHandle),
lpctstrGroupName );
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_AddOutboundGroup. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
}
#ifndef UNICODE
FaxAddOutboundGroupX (
IN HANDLE hFaxHandle,
IN LPCSTR lpctstrGroupName
)
{
UNREFERENCED_PARAMETER (hFaxHandle);
UNREFERENCED_PARAMETER (lpctstrGroupName);
SetLastError (ERROR_CALL_NOT_IMPLEMENTED);
return FALSE;
}
#endif // #ifndef UNICODE
BOOL
WINAPI
FaxSetOutboundGroupA (
IN HANDLE hFaxHandle,
IN PFAX_OUTBOUND_ROUTING_GROUPA pGroup
)
{
FAX_OUTBOUND_ROUTING_GROUPW GroupW;
BOOL bRes;
DEBUG_FUNCTION_NAME(TEXT("FaxSetOutboundGroupA"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!pGroup)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pGroup is NULL."));
return FALSE;
}
if (sizeof (FAX_OUTBOUND_ROUTING_GROUPA) != pGroup->dwSizeOfStruct)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("sizeof (FAX_OUTBOUND_ROUTING_GROUPA) != pGroup->dwSizeOfStruct."));
return FALSE;
}
if (!pGroup->lpctstrGroupName)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pGroup->lpctstrGroupName is NULL."));
return FALSE;
}
if (strlen (pGroup->lpctstrGroupName) >= MAX_ROUTING_GROUP_NAME)
{
SetLastError(ERROR_BUFFER_OVERFLOW);
DebugPrintEx(DEBUG_ERR, _T("strlen (pGroup->lpctstrGroupName) >= MAX_ROUTING_GROUP_NAME."));
return FALSE;
}
if (!pGroup->lpdwDevices && pGroup->dwNumDevices)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("!pGroup->lpdwDevices && pGroup->dwNumDevices."));
return FALSE;
}
//
// Create a UNICODE structure and pass along to UNICODE function
// Ansi structure is same size as unicode structure, so we can just copy it, then
// cast the string pointers correctly
//
CopyMemory(&GroupW, pGroup, sizeof(FAX_OUTBOUND_ROUTING_GROUPA));
GroupW.dwSizeOfStruct = sizeof (FAX_OUTBOUND_ROUTING_GROUPW);
if (NULL == (GroupW.lpctstrGroupName = AnsiStringToUnicodeString(pGroup->lpctstrGroupName)))
{
DebugPrintEx(
DEBUG_ERR,
TEXT("AnsiStringToUnicodeString failed. (ec: %ld)"),
GetLastError());
return FALSE;
}
bRes = FaxSetOutboundGroupW (hFaxHandle, &GroupW);
MemFree((PVOID)GroupW.lpctstrGroupName);
return bRes;
}
BOOL
WINAPI
FaxSetOutboundGroupW (
IN HANDLE hFaxHandle,
IN PFAX_OUTBOUND_ROUTING_GROUPW pGroup
)
/*++
Routine name : FaxSetOutboundGroupW
Routine description:
Sets an outbound routing group settings for a Fax server
Author:
Oded Sacher (OdedS), Nov, 1999
Arguments:
hFaxHandle [in] - Fax server handle
pGroup [in] - Pointer to a FAX_OUTBOUND_ROUTING_GROUP buffer to set
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxSetOutboundGroupW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!pGroup)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pGroup is NULL."));
return FALSE;
}
if (sizeof (FAX_OUTBOUND_ROUTING_GROUPW) != pGroup->dwSizeOfStruct)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("sizeof (FAX_OUTBOUND_ROUTING_GROUPW) != pGroup->dwSizeOfStruct."));
return FALSE;
}
if (!pGroup->lpctstrGroupName)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pGroup->lpctstrGroupName is NULL."));
return FALSE;
}
if (wcslen (pGroup->lpctstrGroupName) >= MAX_ROUTING_GROUP_NAME)
{
SetLastError(ERROR_BUFFER_OVERFLOW);
DebugPrintEx(DEBUG_ERR, _T("wcslen (pGroup->lpctstrGroupName) >= MAX_ROUTING_GROUP_NAME."));
return FALSE;
}
if (!pGroup->lpdwDevices && pGroup->dwNumDevices)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("!pGroup->lpdwDevices && pGroup->dwNumDevices."));
return FALSE;
}
Assert (sizeof (RPC_FAX_OUTBOUND_ROUTING_GROUPW) == sizeof (FAX_OUTBOUND_ROUTING_GROUPW));
__try
{
ec = FAX_SetOutboundGroup( FH_FAX_HANDLE(hFaxHandle),
(PRPC_FAX_OUTBOUND_ROUTING_GROUPW)pGroup
);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_SetOutboundGroup. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
}
#ifndef UNICODE
FaxSetOutboundGroupX (
IN HANDLE hFaxHandle,
IN PFAX_OUTBOUND_ROUTING_GROUPW pGroup
)
{
UNREFERENCED_PARAMETER (hFaxHandle);
UNREFERENCED_PARAMETER (pGroup);
SetLastError (ERROR_CALL_NOT_IMPLEMENTED);
return FALSE;
}
#endif // #ifndef UNICODE
WINFAXAPI
BOOL
WINAPI
FaxEnumOutboundGroupsA (
IN HANDLE hFaxHandle,
OUT PFAX_OUTBOUND_ROUTING_GROUPA *ppGroups,
OUT LPDWORD lpdwNumGroups
)
{
PFAX_OUTBOUND_ROUTING_GROUPW pGroup;
DWORD i;
DEBUG_FUNCTION_NAME(TEXT("FaxEnumOutboundGroupsA"));
//
// no need to validate parameters, FaxEnumOutboundGroupsW() will do that
//
if (!FaxEnumOutboundGroupsW (hFaxHandle,
(PFAX_OUTBOUND_ROUTING_GROUPW*) ppGroups,
lpdwNumGroups))
{
DebugPrintEx(DEBUG_ERR, _T("FaxEnumOutboundGroupsW() is failed. (ec: %ld)"), GetLastError());
return FALSE;
}
pGroup = (PFAX_OUTBOUND_ROUTING_GROUPW) *ppGroups;
for (i = 0; i < *lpdwNumGroups; i++)
{
if (!ConvertUnicodeStringInPlace((LPWSTR) pGroup[i].lpctstrGroupName))
{
DebugPrintEx(DEBUG_ERR, _T("ConvertUnicodeStringInPlace failed, ec = %ld."), GetLastError());
MemFree (*ppGroups);
return FALSE;
}
}
return TRUE;
} //FaxEnumOutboundGroupsA
WINFAXAPI
BOOL
WINAPI
FaxEnumOutboundGroupsW (
IN HANDLE hFaxHandle,
OUT PFAX_OUTBOUND_ROUTING_GROUPW *ppGroups,
OUT LPDWORD lpdwNumGroups
)
/*++
Routine name : FaxEnumOutboundGroupsW
Routine description:
Enumerates all the outbound routing groups of a fax server.
Author:
Oded Sacher (OdedS), Dec, 1999
Arguments:
hFaxHandle [in ] - Specifies a fax server handle returned by a call to the FaxConnectFaxServer function.
ppGroups [out ] - A pointer to a buffer of FAX_OUTBOUND_ROUTING_GROUP structures.
This buffer is allocated by the function and the client should call FaxFreeBuffer to free it.
lpdwNumGroups [out ] - Pointer to a DWORD value indicating the number of groups retrieved.
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DWORD dwBufferSize = 0;
DWORD i;
DEBUG_FUNCTION_NAME(TEXT("FaxEnumOutboundGroupsW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!ppGroups)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("ppGroups is NULL."));
return FALSE;
}
if (!lpdwNumGroups)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("lpdwNumGroups is NULL."));
return FALSE;
}
*ppGroups = NULL;
*lpdwNumGroups = 0;
__try
{
ec = FAX_EnumOutboundGroups( FH_FAX_HANDLE(hFaxHandle),
(LPBYTE*) ppGroups,
&dwBufferSize,
lpdwNumGroups
);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_EnumOutboundGroups. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
//
// Unpack buffer
//
for (i = 0; i < *lpdwNumGroups; i++)
{
FixupStringPtrW( ppGroups, (*ppGroups)[i].lpctstrGroupName );
if ((*ppGroups)[i].lpdwDevices != NULL)
{
(*ppGroups)[i].lpdwDevices =
(LPDWORD)((LPBYTE)(*ppGroups) + (ULONG_PTR)((*ppGroups)[i].lpdwDevices));
}
}
return TRUE;
}//FaxEnumOutboundGroupsW
#ifndef UNICODE
WINFAXAPI
BOOL
WINAPI
FaxEnumOutboundGroupsX (
IN HANDLE hFaxHandle,
OUT PFAX_OUTBOUND_ROUTING_GROUPW *ppGroups,
OUT LPDWORD lpdwNumGroups
)
{
UNREFERENCED_PARAMETER (hFaxHandle);
UNREFERENCED_PARAMETER (ppGroups);
UNREFERENCED_PARAMETER (lpdwNumGroups);
SetLastError (ERROR_CALL_NOT_IMPLEMENTED);
return FALSE;
}
#endif // #ifndef UNICODE
WINFAXAPI
BOOL
WINAPI
FaxRemoveOutboundGroupA (
IN HANDLE hFaxHandle,
IN LPCSTR lpctstrGroupName
)
{
LPWSTR lpwstrGroupName;
BOOL bRes;
DEBUG_FUNCTION_NAME(TEXT("FaxRemoveOutboundGroupA"));
if (NULL == (lpwstrGroupName = AnsiStringToUnicodeString(lpctstrGroupName)))
{
DebugPrintEx(
DEBUG_ERR,
TEXT("AnsiStringToUnicodeString failed. (ec: %ld)"),
GetLastError());
return FALSE;
}
bRes = FaxRemoveOutboundGroupW (hFaxHandle, lpwstrGroupName);
MemFree (lpwstrGroupName);
return bRes;
}//FaxRemoveOutboundGroupA
WINFAXAPI
BOOL
WINAPI
FaxRemoveOutboundGroupW (
IN HANDLE hFaxHandle,
IN LPCWSTR lpctstrGroupName
)
/*++
Routine name : FaxRemoveOutboundGroupW
Routine description:
Removes an existing outbound routing group for a Fax server
Author:
Oded Sacher (OdedS), Nov, 1999
Arguments:
hFaxHandle [ in ] - Fax server handle obtained from a call to FaxConnectFaxServer
lpctstrGroupName [ in ] - A pointer to a null-terminated string that uniqely identifies the group name
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxRemoveOutboundGroupW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!lpctstrGroupName)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("lpctstrGroupName is NULL."));
return FALSE;
}
if (_wcsicmp (lpctstrGroupName, ROUTING_GROUP_ALL_DEVICESW) == 0)
{
SetLastError(ERROR_INVALID_OPERATION);
DebugPrintEx(DEBUG_ERR, _T("_wcsicmp (lpctstrGroupName, ROUTING_GROUP_ALL_DEVICESW) == 0."));
return FALSE;
}
if (wcslen (lpctstrGroupName) >= MAX_ROUTING_GROUP_NAME)
{
SetLastError(ERROR_BUFFER_OVERFLOW);
DebugPrintEx(DEBUG_ERR, _T("wcslen (lpctstrGroupName) >= MAX_ROUTING_GROUP_NAME."));
return FALSE;
}
__try
{
ec = FAX_RemoveOutboundGroup( FH_FAX_HANDLE(hFaxHandle),
lpctstrGroupName );
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_RemoveOutboundGroup. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
}//FaxRemoveOutboundGroupW
#ifndef UNICODE
WINFAXAPI
BOOL
WINAPI
FaxRemoveOutboundGroupX (
IN HANDLE hFaxHandle,
IN LPCWSTR lpctstrGroupName
)
{
UNREFERENCED_PARAMETER (hFaxHandle);
UNREFERENCED_PARAMETER (lpctstrGroupName);
SetLastError (ERROR_CALL_NOT_IMPLEMENTED);
return FALSE;
}
#endif // #ifndef UNICODE
BOOL
WINAPI
FaxSetDeviceOrderInGroupA (
IN HANDLE hFaxHandle,
IN LPCSTR lpctstrGroupName,
IN DWORD dwDeviceId,
IN DWORD dwNewOrder
)
{
LPWSTR lpwstrGroupName;
BOOL bRes;
DEBUG_FUNCTION_NAME(TEXT("FaxSetDeviceOrderInGroupA"));
if (NULL == (lpwstrGroupName = AnsiStringToUnicodeString(lpctstrGroupName)))
{
DebugPrintEx(
DEBUG_ERR,
TEXT("AnsiStringToUnicodeString failed. (ec: %ld)"),
GetLastError());
return FALSE;
}
bRes = FaxSetDeviceOrderInGroupW (hFaxHandle, lpwstrGroupName, dwDeviceId, dwNewOrder);
MemFree (lpwstrGroupName);
return bRes;
}//FaxSetDeviceOrderInGroupA
BOOL
WINAPI
FaxSetDeviceOrderInGroupW (
IN HANDLE hFaxHandle,
IN LPCWSTR lpctstrGroupName,
IN DWORD dwDeviceId,
IN DWORD dwNewOrder
)
/*++
Routine name : FaxSetDeviceOrderInGroupW
Routine description:
Sets the order of a single device in a group of outbound routing devices.
Author:
Oded Sacher (OdedS), Dec, 1999
Arguments:
hFaxHandle [in] - Specifies a fax server handle returned by a call to the FaxConnectFaxServer function
lpctstrGroupName [in] - A pointer to a null-terminated string that uniquely identifies a group.
dwDeviceId [in] - A DWORD value specifying the id of the device in the group. The specified device must exist in the group.
dwNewOrder [in] - A DWORD value specifying the new 1-based order of the device in the group. If there are N devices in the group, this value must be between 1 and N (including).
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxSetDeviceOrderInGroupW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!dwDeviceId)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("dwDeviceId is ZERO."));
return FALSE;
}
if (!dwNewOrder)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("dwNewOrder is ZERO."));
return FALSE;
}
if (!lpctstrGroupName)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("lpctstrGroupName is NULL."));
return FALSE;
}
if (wcslen (lpctstrGroupName) >= MAX_ROUTING_GROUP_NAME)
{
DebugPrintEx(DEBUG_ERR, _T("Group name length exceeded MAX_ROUTING_GROUP_NAME"));
SetLastError(ERROR_BUFFER_OVERFLOW);
return FALSE;
}
__try
{
ec = FAX_SetDeviceOrderInGroup( FH_FAX_HANDLE(hFaxHandle),
lpctstrGroupName,
dwDeviceId,
dwNewOrder);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_SetDeviceOrderInGroup. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
}//FaxSetDeviceOrderInGroupW
#ifndef UNICODE
BOOL
WINAPI
FaxSetDeviceOrderInGroupX (
IN HANDLE hFaxHandle,
IN LPCWSTR lpctstrGroupName,
IN DWORD dwDeviceId,
IN DWORD dwNewOrder
)
{
UNREFERENCED_PARAMETER (hFaxHandle);
UNREFERENCED_PARAMETER (lpctstrGroupName);
UNREFERENCED_PARAMETER (dwDeviceId);
UNREFERENCED_PARAMETER (dwNewOrder);
SetLastError (ERROR_CALL_NOT_IMPLEMENTED);
return FALSE;
}
#endif // #ifndef UNICODE
BOOL
WINAPI
FaxAddOutboundRuleA (
IN HANDLE hFaxHandle,
IN DWORD dwAreaCode,
IN DWORD dwCountryCode,
IN DWORD dwDeviceID,
IN LPCSTR lpctstrGroupName,
IN BOOL bUseGroup
)
{
LPWSTR lpwstrGroupName = NULL;
BOOL bRes;
DEBUG_FUNCTION_NAME(TEXT("FaxAddOutboundRuleA"));
if (TRUE == bUseGroup)
{
if (!lpctstrGroupName)
{
DebugPrintEx(
DEBUG_ERR,
TEXT("lpctstrGroupName is NULL"));
SetLastError(ERROR_INVALID_PARAMETER);
return FALSE;
}
if (NULL == (lpwstrGroupName = AnsiStringToUnicodeString(lpctstrGroupName)))
{
DebugPrintEx(
DEBUG_ERR,
TEXT("AnsiStringToUnicodeString failed. (ec: %ld)"),
GetLastError());
return FALSE;
}
}
bRes = FaxAddOutboundRuleW (hFaxHandle,
dwAreaCode,
dwCountryCode,
dwDeviceID,
lpwstrGroupName,
bUseGroup);
MemFree (lpwstrGroupName);
return bRes;
}
BOOL
WINAPI
FaxAddOutboundRuleW (
IN HANDLE hFaxHandle,
IN DWORD dwAreaCode,
IN DWORD dwCountryCode,
IN DWORD dwDeviceID,
IN LPCWSTR lpctstrGroupName,
IN BOOL bUseGroup
)
/*++
Routine name : FaxAddOutboundRuleW
Routine description:
Adds a new outbound routing rule to the fax service
Author:
Oded Sacher (OdedS), Dec, 1999
Arguments:
hFaxHandle [in] - Specifies a fax server handle returned by a call to the FaxConnectFaxServer function.
dwAreaCode [in] - The area code of the rule.
dwCountryCode [in] - The country code of the rule.
dwDeviceID [in] - The destination device of the rule.
lpctstrGroupName [in] - The destination group of the rule. This value is valid only if the bUseGroup member is TRUE.
bUseGroup [in] - A Boolean value specifying whether the group should be used as the destination.
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxAddOutboundRuleW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (dwCountryCode == ROUTING_RULE_COUNTRY_CODE_ANY)
{
//
// *.* can not be added; *.AreaCode is not a valid rule dialing location.
//
DebugPrintEx(DEBUG_ERR,
_T("dwCountryCode = 0; *.* can not be added; *.AreaCode is not a valid rule dialing location"));
SetLastError(ERROR_INVALID_PARAMETER);
return FALSE;
}
if (TRUE == bUseGroup)
{
if (!lpctstrGroupName)
{
DebugPrintEx(DEBUG_ERR, _T("lpctstrGroupName is NULL"));
SetLastError(ERROR_INVALID_PARAMETER);
return FALSE;
}
if (wcslen (lpctstrGroupName) >= MAX_ROUTING_GROUP_NAME)
{
DebugPrintEx(DEBUG_ERR, _T("Group name length exceeded MAX_ROUTING_GROUP_NAME"));
SetLastError(ERROR_BUFFER_OVERFLOW);
return FALSE;
}
}
else
{
if (!dwDeviceID)
{
DebugPrintEx(DEBUG_ERR, _T("dwDeviceId = 0; Not a valid device ID"));
SetLastError(ERROR_INVALID_PARAMETER);
return FALSE;
}
lpctstrGroupName = NULL;
}
__try
{
ec = FAX_AddOutboundRule( FH_FAX_HANDLE(hFaxHandle),
dwAreaCode,
dwCountryCode,
dwDeviceID,
lpctstrGroupName,
bUseGroup);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_AddOutboundRule. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
} //FaxAddOutboundRuleW
#ifndef UNICODE
BOOL
WINAPI
FaxAddOutboundRuleX (
IN HANDLE hFaxHandle,
IN DWORD dwAreaCode,
IN DWORD dwCountryCode,
IN DWORD dwDeviceID,
IN LPCWSTR lpctstrGroupName,
IN BOOL bUseGroup
)
{
UNREFERENCED_PARAMETER (hFaxHandle);
UNREFERENCED_PARAMETER (dwAreaCode);
UNREFERENCED_PARAMETER (dwCountryCode);
UNREFERENCED_PARAMETER (dwDeviceID);
UNREFERENCED_PARAMETER (lpctstrGroupName);
UNREFERENCED_PARAMETER (bUseGroup);
SetLastError (ERROR_CALL_NOT_IMPLEMENTED);
return FALSE;
}
#endif // #ifndef UNICODE
BOOL
WINAPI
FaxRemoveOutboundRule (
IN HANDLE hFaxHandle,
IN DWORD dwAreaCode,
IN DWORD dwCountryCode
)
/*++
Routine name : FaxRemoveOutboundRule
Routine description:
Removes an existing outbound routing rule from the fax service
Author:
Oded Sacher (OdedS), Dec, 1999
Arguments:
hFaxHandle [in] - Specifies a fax server handle returned by a call to the FaxConnectFaxServer function.
dwAreaCode [in] - The area code of the rule.
dwCountryCode [in] - The country code of the rule.
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxRemoveOutboundRule"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (dwCountryCode == ROUTING_RULE_COUNTRY_CODE_ANY)
{
//
// *.* can not be removed; *.AreaCode is not a valid rule dialing location.
//
DebugPrintEx(DEBUG_ERR,
_T("dwCountryCode = 0; *.* can not be removed; *.AreaCode is not a valid rule dialing location"));
SetLastError(ERROR_INVALID_PARAMETER);
return FALSE;
}
__try
{
ec = FAX_RemoveOutboundRule( FH_FAX_HANDLE(hFaxHandle),
dwAreaCode,
dwCountryCode);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_RemoveOutboundRule. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
} // FaxRemoveOutboundRule
BOOL
WINAPI
FaxEnumOutboundRulesA (
IN HANDLE hFaxHandle,
OUT PFAX_OUTBOUND_ROUTING_RULEA *ppRules,
OUT LPDWORD lpdwNumRules
)
{
PFAX_OUTBOUND_ROUTING_RULEW pRule;
DWORD i;
DEBUG_FUNCTION_NAME(TEXT("FaxEnumOutboundRulesA"));
//
// no need to validate parameters, FaxEnumOutboundRulesW() will do that
//
if (!FaxEnumOutboundRulesW (hFaxHandle,
(PFAX_OUTBOUND_ROUTING_RULEW*) ppRules,
lpdwNumRules))
{
DebugPrintEx(DEBUG_ERR, _T("FaxEnumOutboundRulesW() is failed. (ec: %ld)"), GetLastError());
return FALSE;
}
pRule = (PFAX_OUTBOUND_ROUTING_RULEW) *ppRules;
for (i = 0; i < *lpdwNumRules; i++)
{
if (TRUE == pRule[i].bUseGroup)
{
if (!ConvertUnicodeStringInPlace((LPWSTR) pRule[i].Destination.lpcstrGroupName))
{
DebugPrintEx(DEBUG_ERR, _T("ConvertUnicodeStringInPlace failed, ec = %ld."), GetLastError());
MemFree (*ppRules);
return FALSE;
}
}
if (!ConvertUnicodeStringInPlace((LPWSTR) pRule[i].lpctstrCountryName))
{
DebugPrintEx(DEBUG_ERR, _T("ConvertUnicodeStringInPlace failed, ec = %ld."), GetLastError());
MemFree (*ppRules);
return FALSE;
}
}
return TRUE;
} // FaxEnumOutboundRulesA
BOOL
WINAPI
FaxEnumOutboundRulesW (
IN HANDLE hFaxHandle,
OUT PFAX_OUTBOUND_ROUTING_RULEW *ppRules,
OUT LPDWORD lpdwNumRules
)
/*++
Routine name : FaxEnumOutboundRulesW
Routine description:
Enumerates all the outbound routing rules of a fax server.
Author:
Oded Sacher (OdedS), Dec, 1999
Arguments:
hFaxHandle [in] - Specifies a fax server handle returned by a call to the FaxConnectFaxServer function.
ppRules [out] - A pointer to a buffer of FAX_OUTBOUND_ROUTING_RULE structures.
This buffer is allocated by the function and the client should call FaxFreeBuffer to free it.
lpdwNumRules [out] - Pointer to a DWORD value indicating the number of rules retrieved.
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DWORD dwBufferSize = 0;
DWORD i;
DEBUG_FUNCTION_NAME(TEXT("FaxEnumOutboundRulesW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() failed."));
return FALSE;
}
if (!ppRules)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("ppRules is NULL"));
return FALSE;
}
if (!lpdwNumRules)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("lpdwNumRules is NULL."));
return FALSE;
}
*ppRules = NULL;
*lpdwNumRules = 0;
__try
{
ec = FAX_EnumOutboundRules( FH_FAX_HANDLE(hFaxHandle),
(LPBYTE*) ppRules,
&dwBufferSize,
lpdwNumRules
);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_EnumOutboundRules. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
//
// Unpack buffer
//
for (i = 0; i < *lpdwNumRules; i++)
{
if (TRUE == (*ppRules)[i].bUseGroup)
{
FixupStringPtrW( ppRules, (*ppRules)[i].Destination.lpcstrGroupName );
}
FixupStringPtrW( ppRules, (*ppRules)[i].lpctstrCountryName);
}
return TRUE;
} // FaxEnumOutboundRulesW
#ifndef UNICODE
BOOL
WINAPI
FaxEnumOutboundRulesX (
IN HANDLE hFaxHandle,
OUT PFAX_OUTBOUND_ROUTING_RULEW *ppRules,
OUT LPDWORD lpdwNumRules
)
{
UNREFERENCED_PARAMETER (hFaxHandle);
UNREFERENCED_PARAMETER (ppRules);
UNREFERENCED_PARAMETER (lpdwNumRules);
return FALSE;
} // FaxEnumOutboundRulesX
#endif // #ifndef UNICODE
BOOL
WINAPI
FaxSetOutboundRuleA (
IN HANDLE hFaxHandle,
IN PFAX_OUTBOUND_ROUTING_RULEA pRule
)
{
FAX_OUTBOUND_ROUTING_RULEW RuleW;
BOOL bRes;
DEBUG_FUNCTION_NAME(TEXT("FaxSetOutboundRuleA"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE)) {
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!pRule) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pRule is NULL."));
return FALSE;
}
if (pRule->dwSizeOfStruct != sizeof(FAX_OUTBOUND_ROUTING_RULEA)) {
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pRule->dwSizeOfStruct != sizeof(FAX_OUTBOUND_ROUTING_RULEA)."));
return FALSE;
}
//
// Create a UNICODE structure and pass along to UNICODE function
// Ansi structure is same size as unicode structure, so we can just copy it, then
// cast the string pointers correctly
//
CopyMemory(&RuleW, pRule, sizeof(FAX_OUTBOUND_ROUTING_RULEA));
RuleW.dwSizeOfStruct = sizeof (FAX_OUTBOUND_ROUTING_RULEW);
if (TRUE == pRule->bUseGroup)
{
if (!(pRule->Destination).lpcstrGroupName)
{
DebugPrintEx(DEBUG_ERR, _T("lpcstrGroupName is NULL"));
SetLastError(ERROR_INVALID_PARAMETER);
return FALSE;
}
if (NULL == (RuleW.Destination.lpcstrGroupName =
AnsiStringToUnicodeString((pRule->Destination).lpcstrGroupName)))
{
DebugPrintEx(DEBUG_ERR, _T("AnsiStringToUnicodeString failed. (ec: %ld)"), GetLastError());
return FALSE;
}
}
bRes = FaxSetOutboundRuleW (hFaxHandle, &RuleW);
if (TRUE == pRule->bUseGroup)
{
MemFree ((void*)(RuleW.Destination.lpcstrGroupName));
}
return bRes;
} // FaxSetOutboundRuleA
BOOL
WINAPI
FaxSetOutboundRuleW (
IN HANDLE hFaxHandle,
IN PFAX_OUTBOUND_ROUTING_RULEW pRule
)
/*++
Routine name : FaxSetOutboundRuleW
Routine description:
Sets an outbound routing rule settings for a fax server.
Author:
Oded Sacher (OdedS), Dec, 1999
Arguments:
hFaxHandle [in] - Specifies a fax server handle returned by a call to the FaxConnectFaxServer function.
pRule [in] - A pointer to a FAX_OUTBOUND_ROUTING_RULE buffer to set.
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
FAX_OUTBOUND_ROUTING_RULEW Rule;
DEBUG_FUNCTION_NAME(TEXT("FaxSetOutboundRuleW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!pRule)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pRule is NULL."));
return FALSE;
}
if (pRule->dwSizeOfStruct != sizeof(FAX_OUTBOUND_ROUTING_RULEW))
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pRule->dwSizeOfStruct != sizeof(FAX_OUTBOUND_ROUTING_RULEW)."));
return FALSE;
}
if (pRule->dwCountryCode == ROUTING_RULE_COUNTRY_CODE_ANY &&
pRule->dwAreaCode != ROUTING_RULE_AREA_CODE_ANY)
{
//
// *.AreaCode is not a valid rule dialing location.
//
DebugPrintEx(DEBUG_ERR,
_T("dwCountryCode = 0 , dwAreaCode != 0; *.AreaCode is not a valid rule dialing location"));
SetLastError(ERROR_INVALID_PARAMETER);
return FALSE;
}
if (TRUE == pRule->bUseGroup)
{
if (!(pRule->Destination).lpcstrGroupName)
{
DebugPrintEx(DEBUG_ERR, _T("lpcstrGroupName is NULL"));
SetLastError(ERROR_INVALID_PARAMETER);
return FALSE;
}
if (wcslen ((pRule->Destination).lpcstrGroupName) >= MAX_ROUTING_GROUP_NAME)
{
DebugPrintEx(DEBUG_ERR, _T("Group name length exceeded MAX_ROUTING_GROUP_NAME"));
SetLastError(ERROR_BUFFER_OVERFLOW);
return FALSE;
}
}
else
{
if (!(pRule->Destination).dwDeviceId)
{
DebugPrintEx(DEBUG_ERR, _T("dwDeviceId = 0; Not a valid device ID"));
SetLastError(ERROR_INVALID_PARAMETER);
return FALSE;
}
}
//
// Zero the country name parameter of the rule before calling the RPC function.
// This parameter is out only but the RPC client will try to marshal it if we don't NULL it.
// This should be done in the IDL but due to backwards compatability issues with BOS Fax, we can't change that.
//
Rule = *pRule;
Rule.lpctstrCountryName = NULL;
__try
{
ec = FAX_SetOutboundRule( FH_FAX_HANDLE(hFaxHandle),
(PRPC_FAX_OUTBOUND_ROUTING_RULEW)&Rule);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_SetOutboundRule. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
} // FaxSetOutboundRuleW
#ifndef UNICODE
BOOL
WINAPI
FaxSetOutboundRuleX (
IN HANDLE hFaxHandle,
IN PFAX_OUTBOUND_ROUTING_RULEW pRule
)
{
UNREFERENCED_PARAMETER (hFaxHandle);
UNREFERENCED_PARAMETER (pRule);
return FALSE;
} // FaxSetOutboundRuleX
#endif // #ifndef UNICODE
BOOL
WINAPI
FaxGetServerActivity (
IN HANDLE hFaxHandle,
OUT PFAX_SERVER_ACTIVITY pServerActivity
)
/*++
Routine name : FaxGetServerActivity
Routine description:
Retrieves the status of the fax server queue activity and event log reports.
Author:
Oded Sacher (OdedS), Feb, 2000
Arguments:
hFaxHandle [in] - Specifies a fax server handle returned by a call to the FaxConnectFaxServer function.
pServerActivity [in] - A pointer to a FAX_SERVER_ACTIVITY object.
The object will be allocated and freed by the calling client.
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxGetServerActivity"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!pServerActivity)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pServerActivity is NULL."));
return FALSE;
}
if (sizeof (FAX_SERVER_ACTIVITY) != pServerActivity->dwSizeOfStruct)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("sizeof (FAX_SERVER_ACTIVITY) != pServerActivity->dwSizeOfStruct."));
return FALSE;
}
__try
{
ec = FAX_GetServerActivity( FH_FAX_HANDLE(hFaxHandle),
pServerActivity);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_GetServerActivity. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
} // FaxGetServerActivity
BOOL
WINAPI
FaxGetReceiptsOptions (
IN HANDLE hFaxHandle,
OUT PDWORD pdwReceiptsOptions
)
/*++
Routine name : FaxGetReceiptsOptions
Routine description:
Retrieves the supported receipt options on the server.
Author:
Eran Yariv (EranY), July, 2000
Arguments:
hFaxHandle [in] - Specifies a fax server handle returned by a call to the FaxConnectFaxServer function.
pdwReceiptsOptions [out] - Buffer to receive receipts options (bit-wise combination of DRT_* constants)
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxGetReceiptsOptions"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!pdwReceiptsOptions)
{
DebugPrintEx(DEBUG_ERR, _T("pdwReceiptsOptions is NULL"));
SetLastError(ERROR_INVALID_PARAMETER);
return FALSE;
}
__try
{
ec = FAX_GetReceiptsOptions( FH_FAX_HANDLE(hFaxHandle),
pdwReceiptsOptions);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_GetReceiptsOptions. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
} // FaxGetReceiptsOptions
BOOL
WINAPI
FaxGetPersonalCoverPagesOption (
IN HANDLE hFaxHandle,
OUT LPBOOL lpbPersonalCPAllowed
)
/*++
Routine name : FaxGetPersonalCoverPagesOption
Routine description:
Retrieves if the server supports personal cover pages
Author:
Eran Yariv (EranY), July, 2000
Arguments:
hFaxHandle [in] - Specifies a fax server handle returned by a call to the FaxConnectFaxServer function.
lpbPersonalCPAllowed [out] - Buffer to receive server support of personal coverpages.
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxGetPersonalCoverPagesOption"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!lpbPersonalCPAllowed)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("lpbPersonalCPAllowed is NULL"));
return FALSE;
}
__try
{
ec = FAX_GetPersonalCoverPagesOption( FH_FAX_HANDLE(hFaxHandle),
lpbPersonalCPAllowed);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_GetPersonalCoverPagesOption. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
} // FaxGetPersonalCoverPagesOption
BOOL
WINAPI
FaxGetConfigWizardUsed (
OUT LPBOOL lpbConfigWizardUsed
)
/*++
Routine name : FaxGetConfigWizardUsed
Routine description:
Retrieves if the configuration wizard (devices) was run on the server.
Author:
Eran Yariv (EranY), July, 2000
Arguments:
lpbConfigWizardUsed [out] - Buffer to receive config wizard usage flag.
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
DWORD dwRes = ERROR_SUCCESS;
DWORD dwRes2;
HKEY hKey;
DEBUG_FUNCTION_NAME(TEXT("FaxGetConfigWizardUsed"));
if (!lpbConfigWizardUsed)
{
DebugPrintEx(DEBUG_ERR, _T("lpbConfigWizardUsed is NULL"));
SetLastError(ERROR_INVALID_PARAMETER);
return FALSE;
}
dwRes = RegOpenKeyEx (HKEY_LOCAL_MACHINE, REGKEY_FAX_CLIENT, 0, KEY_READ, &hKey);
if (ERROR_SUCCESS != dwRes)
{
DebugPrintEx(
DEBUG_ERR,
TEXT("Error opening server key (ec = %ld)"),
dwRes);
goto exit;
}
*lpbConfigWizardUsed = GetRegistryDword (hKey, REGVAL_CFGWZRD_DEVICE);
dwRes2 = RegCloseKey (hKey);
if (ERROR_SUCCESS != dwRes2)
{
DebugPrintEx(
DEBUG_ERR,
TEXT("Error closing server key (ec = %ld)"),
dwRes2);
}
Assert (ERROR_SUCCESS == dwRes);
exit:
if (ERROR_SUCCESS != dwRes)
{
SetLastError(dwRes);
return FALSE;
}
return TRUE;
} // FaxGetConfigWizardUsed
BOOL
WINAPI
FaxSetConfigWizardUsed (
IN HANDLE hFaxHandle,
IN BOOL bConfigWizardUsed
)
/*++
Routine name : FaxSetConfigWizardUsed
Routine description:
Sets if the configuration wizard (devices) was run on the server.
Author:
Eran Yariv (EranY), July, 2000
Arguments:
hFaxHandle [in] - Specifies a fax server handle returned by a call to the FaxConnectFaxServer function.
bConfigWizardUsed [in] - Was the configuration wizard used?
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec;
DEBUG_FUNCTION_NAME(TEXT("FaxSetConfigWizardUsed"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!IsLocalFaxConnection(hFaxHandle))
{
DebugPrintEx(DEBUG_ERR, _T("Not a local fax connection"));
SetLastError(ERROR_INVALID_HANDLE);
return FALSE;
}
if (FAX_API_VERSION_1 > FH_SERVER_VER(hFaxHandle))
{
//
// Servers of API version 0 don't support FAX_SetConfigWizardUsed
//
ASSERT_FALSE; // Can't happen - if it's local
DebugPrintEx(DEBUG_ERR,
_T("Server version is %ld - doesn't support this call"),
FH_SERVER_VER(hFaxHandle));
SetLastError(FAX_ERR_VERSION_MISMATCH);
return FALSE;
}
__try
{
ec = FAX_SetConfigWizardUsed( FH_FAX_HANDLE(hFaxHandle),
bConfigWizardUsed);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_SetConfigWizardUsed. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
return TRUE;
} // FaxSetConfigWizardUsed
//********************************************
//* Routing extensions
//********************************************
BOOL
WINAPI
FaxEnumRoutingExtensionsA (
IN HANDLE hFaxHandle,
OUT PFAX_ROUTING_EXTENSION_INFOA *ppExts,
OUT LPDWORD lpdwNumExts
)
/*++
Routine name : FaxEnumRoutingExtensionsA
Routine description:
Enumerates routing extensions - ANSI version
Author:
Eran Yariv (EranY), July, 2000
Arguments:
hFaxHandle [in ] - Handle to fax server
ppExts [out] - Pointer to buffer to return array of extensions.
lpdwNumExts [out] - Number of extensions returned in the array.
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
PFAX_ROUTING_EXTENSION_INFOW pUnicodeExts;
DWORD dwNumExts;
DWORD dwCur;
DEBUG_FUNCTION_NAME(TEXT("FaxEnumRoutingExtensionsA"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!ppExts)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("ppExts is NULL."));
return FALSE;
}
if (!lpdwNumExts)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pdwNumExts is NULL."));
return FALSE;
}
//
// Call the UNICODE version first
//
if (!FaxEnumRoutingExtensionsW (hFaxHandle, &pUnicodeExts, &dwNumExts))
{
DebugPrintEx(DEBUG_ERR, _T("FaxEnumRoutingExtensionsW() is failed. ec = %ld."), GetLastError());
return FALSE;
}
//
// Convert returned value back into ANSI.
// We keep the UNICODE structures and do a UNICODE to ANSI convert in place.
//
*lpdwNumExts = dwNumExts;
*ppExts = (PFAX_ROUTING_EXTENSION_INFOA) pUnicodeExts;
for (dwCur = 0; dwCur < dwNumExts; dwCur++)
{
if (!ConvertUnicodeStringInPlace(pUnicodeExts[dwCur].lpctstrFriendlyName) ||
!ConvertUnicodeStringInPlace(pUnicodeExts[dwCur].lpctstrImageName) ||
!ConvertUnicodeStringInPlace(pUnicodeExts[dwCur].lpctstrExtensionName))
{
DebugPrintEx(DEBUG_ERR, _T("ConvertUnicodeStringInPlace failed, ec = %ld."), GetLastError());
MemFree (pUnicodeExts);
return FALSE;
}
}
return TRUE;
} // FaxEnumRoutingExtensionsA
BOOL
WINAPI
FaxEnumRoutingExtensionsW (
IN HANDLE hFaxHandle,
OUT PFAX_ROUTING_EXTENSION_INFOW *ppExts,
OUT LPDWORD lpdwNumExts
)
/*++
Routine name : FaxEnumRoutingExtensionsW
Routine description:
Enumerates routing extensions - UNICODE version
Author:
Eran Yariv (EranY), July, 2000
Arguments:
hFaxHandle [in ] - Handle to fax server
ppExts [out] - Pointer to buffer to return array of extensions.
lpdwNumExts [out] - Number of extensions returned in the array.
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
DWORD ec = ERROR_SUCCESS;
DWORD dwConfigSize;
DWORD dwCur;
DEBUG_FUNCTION_NAME(TEXT("FaxEnumRoutingExtensionsW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle,FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!ppExts)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("ppExts is NULL."));
return FALSE;
}
if (!lpdwNumExts)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("pdwNumExts is NULL."));
return FALSE;
}
*ppExts = NULL;
if (FAX_API_VERSION_1 > FH_SERVER_VER(hFaxHandle))
{
//
// Servers of API version 0 don't support FAX_EnumRoutingExtensions
// We'll fake it and return an empty list.
//
DebugPrintEx(DEBUG_MSG,
_T("Server version is %ld - doesn't support this call"),
FH_SERVER_VER(hFaxHandle));
SetLastError(FAX_ERR_VERSION_MISMATCH);
return FALSE;
}
//
// Call the RPC function
//
__try
{
ec = FAX_EnumRoutingExtensions(
FH_FAX_HANDLE(hFaxHandle),
(LPBYTE*)ppExts,
&dwConfigSize,
lpdwNumExts
);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_EnumRoutingExtensions. (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
for (dwCur = 0; dwCur < (*lpdwNumExts); dwCur++)
{
FixupStringPtrW( ppExts, (*ppExts)[dwCur].lpctstrFriendlyName );
FixupStringPtrW( ppExts, (*ppExts)[dwCur].lpctstrImageName );
FixupStringPtrW( ppExts, (*ppExts)[dwCur].lpctstrExtensionName );
}
return TRUE;
} // FaxEnumRoutingExtensionsW
#ifndef UNICODE
BOOL
WINAPI
FaxEnumRoutingExtensionsX (
IN HANDLE hFaxHandle,
OUT PFAX_ROUTING_EXTENSION_INFOW *ppExts,
OUT LPDWORD lpdwNumExts
)
{
UNREFERENCED_PARAMETER (hFaxHandle);
UNREFERENCED_PARAMETER (ppExts);
UNREFERENCED_PARAMETER (lpdwNumExts);
SetLastError (ERROR_CALL_NOT_IMPLEMENTED);
return FALSE;
} // FaxEnumRoutingExtensionsX
#endif // #ifndef UNICODE
WINFAXAPI
BOOL
WINAPI
FaxGetServicePrintersA(
IN HANDLE hFaxHandle,
OUT PFAX_PRINTER_INFOA *ppPrinterInfo,
OUT LPDWORD lpdwPrintersReturned
)
/*++
Routine name : FaxGetServicePrintersA
Routine description:
Retrieves Information about Printers that are known by the Service
Author:
Iv Garber (IvG), August, 2000
Arguments:
hFaxHandle [in] - Specifies a fax server handle returned by a call to the FaxConnectFaxServer function.
pPrinterInfo [out] - Buffer to receive the Printers Info
PrintersReturned[out] - Count of the Printers Info structures returned
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
DEBUG_FUNCTION_NAME(TEXT("FaxGetServicePrintersA"));
//
// no need to validate parameters, FaxGetServicePrintersW() will do that
//
if (!FaxGetServicePrintersW(hFaxHandle,
(PFAX_PRINTER_INFOW *)ppPrinterInfo,
lpdwPrintersReturned))
{
DebugPrintEx(DEBUG_ERR, _T("FaxGetServicePrintersW() failed. (ec: %ld)"), GetLastError());
return FALSE;
}
DWORD i;
for ( i = 0 ; i < (*lpdwPrintersReturned) ; i++ )
{
if (!ConvertUnicodeStringInPlace((LPWSTR) (*ppPrinterInfo)[i].lptstrPrinterName) ||
!ConvertUnicodeStringInPlace((LPWSTR) (*ppPrinterInfo)[i].lptstrDriverName) ||
!ConvertUnicodeStringInPlace((LPWSTR) (*ppPrinterInfo)[i].lptstrServerName))
{
DebugPrintEx(DEBUG_ERR, _T("ConvertUnicodeStringInPlace failed, ec = %ld."), GetLastError());
MemFree (*ppPrinterInfo);
return FALSE;
}
}
return TRUE;
} // FaxGetServicePrintersA
WINFAXAPI
BOOL
WINAPI
FaxGetServicePrintersW(
IN HANDLE hFaxHandle,
OUT PFAX_PRINTER_INFOW *ppPrinterInfo,
OUT LPDWORD lpdwPrintersReturned
)
/*++
Routine name : FaxGetServicePrintersW
Routine description:
Retrieves Information about Printers that are known by the Service
Author:
Iv Garber (IvG), August, 2000
Arguments:
hFaxHandle [in] - Specifies a fax server handle returned by a call to the FaxConnectFaxServer function.
pPrinterInfo [out] - Buffer to receive the Printers Info
PrintersReturned[out] - Count of the Printers Info structures returned
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
DEBUG_FUNCTION_NAME(TEXT("FaxGetServicePrintersW"));
//
// Validate Parameters
//
if (!ValidateFaxHandle(hFaxHandle, FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() is failed."));
return FALSE;
}
if (!ppPrinterInfo)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("ppPrinterInfo is NULL."));
return FALSE;
}
if (!lpdwPrintersReturned)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("lpdwPrintersReturned is NULL."));
return FALSE;
}
error_status_t ec;
DWORD dwBufferSize = 0;
*ppPrinterInfo = NULL;
*lpdwPrintersReturned = 0;
__try
{
ec = FAX_GetServicePrinters(FH_FAX_HANDLE(hFaxHandle),
(LPBYTE *)ppPrinterInfo,
&dwBufferSize,
lpdwPrintersReturned);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(DEBUG_ERR, _T("Exception on RPC call to FAX_GetServicePrinters. (ec: %ld)"), ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
SetLastError(ec);
return FALSE;
}
PFAX_PRINTER_INFOW pPrinter = (PFAX_PRINTER_INFOW) (*ppPrinterInfo);
for ( DWORD i = 0; i < (*lpdwPrintersReturned) ; i++ )
{
FixupStringPtrW( ppPrinterInfo, pPrinter[i].lptstrPrinterName);
FixupStringPtrW( ppPrinterInfo, pPrinter[i].lptstrDriverName);
FixupStringPtrW( ppPrinterInfo, pPrinter[i].lptstrServerName);
}
return TRUE;
}
#ifndef UNICODE
WINFAXAPI
BOOL
WINAPI
FaxGetServicePrintersX(
IN HANDLE hFaxHandle,
OUT PFAX_PRINTER_INFOW *pPrinterInfo,
OUT LPDWORD PrintersReturned
)
{
UNREFERENCED_PARAMETER (hFaxHandle);
UNREFERENCED_PARAMETER (pPrinterInfo);
UNREFERENCED_PARAMETER (PrintersReturned);
SetLastError(ERROR_CALL_NOT_IMPLEMENTED);
return FALSE;
} // FaxGetServicePrintersX
#endif // #ifndef UNICODE
//********************************************
//* Manual answer support
//********************************************
BOOL
WINAPI
FaxAnswerCall(
IN HANDLE hFaxHandle,
IN CONST DWORD dwDeviceId
)
/*++
Routine Description:
Tells the server to answer specified call
Arguments:
FaxHandle - FAX handle obtained from FaxConnectFaxServer.
dwDeviceId - TAPI Permanent Line Id (from event notification)
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec = ERROR_SUCCESS;
DEBUG_FUNCTION_NAME(TEXT("FaxAnswerCall"));
if (!ValidateFaxHandle(hFaxHandle, FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() failed."));
return FALSE;
}
if (!IsLocalFaxConnection(hFaxHandle))
{
//
// Only local connections are allowed to do a FaxAnswerCall
//
DebugPrintEx(DEBUG_ERR, _T("Not a local fax connection"));
SetLastError(ERROR_INVALID_HANDLE);
return FALSE;
}
if (FAX_API_VERSION_1 > FH_SERVER_VER(hFaxHandle))
{
//
// Servers of API version 0 don't support FAX_AnswerCall
//
DebugPrintEx(DEBUG_ERR,
_T("Server version is %ld - doesn't support this call"),
FH_SERVER_VER(hFaxHandle));
SetLastError(FAX_ERR_VERSION_MISMATCH);
return FALSE;
}
__try
{
ec = FAX_AnswerCall (FH_FAX_HANDLE(hFaxHandle), dwDeviceId);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_AnswerCall (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
DebugPrintEx(DEBUG_ERR, _T("FAX_AnswerCall failed. (ec: %ld)"), ec);
}
return (ERROR_SUCCESS == ec);
} // FaxAnswerCall
//********************************************
//* Ivalidate archive folder
//********************************************
WINFAXAPI
BOOL
WINAPI
FaxRefreshArchive (
IN HANDLE hFaxHandle,
IN FAX_ENUM_MESSAGE_FOLDER Folder
)
/*++
Routine Description:
Tells the server that the folder should be refreshed
Arguments:
FaxHandle - FAX handle obtained from FaxConnectFaxServer.
Folder - Archive folder ID
Return Value:
TRUE - Success
FALSE - Failure, call GetLastError() for more error information.
--*/
{
error_status_t ec = ERROR_SUCCESS;
DEBUG_FUNCTION_NAME(TEXT("FaxRefreshArchive"));
if (!ValidateFaxHandle(hFaxHandle, FHT_SERVICE))
{
SetLastError(ERROR_INVALID_HANDLE);
DebugPrintEx(DEBUG_ERR, _T("ValidateFaxHandle() failed."));
return FALSE;
}
if(Folder != FAX_MESSAGE_FOLDER_INBOX &&
Folder != FAX_MESSAGE_FOLDER_SENTITEMS)
{
SetLastError(ERROR_INVALID_PARAMETER);
DebugPrintEx(DEBUG_ERR, _T("Folder is invalid."));
return FALSE;
}
__try
{
ec = FAX_RefreshArchive (FH_FAX_HANDLE(hFaxHandle), Folder);
}
__except (EXCEPTION_EXECUTE_HANDLER)
{
//
// For some reason we got an exception.
//
ec = GetExceptionCode();
DebugPrintEx(
DEBUG_ERR,
TEXT("Exception on RPC call to FAX_RefreshArchive (ec: %ld)"),
ec);
}
if (ERROR_SUCCESS != ec)
{
DumpRPCExtendedStatus();
DebugPrintEx(DEBUG_ERR, _T("FAX_RefreshArchive failed. (ec: %ld)"), ec);
}
return (ERROR_SUCCESS == ec);
} // FaxRefreshArchive