Функция FaxSetGlobalRoutingInfoA (winfax.h)

Статья
11/20/2024

Приложение управления факсами вызывает функцию FaxSetGlobalRoutingInfo для изменения данных метода маршрутизации факсов, таких как приоритет маршрутизации, которая применяется глобально к факс-серверу.

Синтаксис

WINFAXAPI BOOL FaxSetGlobalRoutingInfoA(
  [in] HANDLE                         FaxHandle,
  [in] const FAX_GLOBAL_ROUTING_INFOA *RoutingInfo
);

Параметры

[in] FaxHandle

Тип: HANDLE

Указывает дескриптор факс-сервера, возвращаемый вызовом функции FaxConnectFaxServer.

[in] RoutingInfo

Тип: const FAX_GLOBAL_ROUTING_INFO*

Указатель на буфер, содержащий структуру FAX_GLOBAL_ROUTING_INFO.

Возвращаемое значение

Тип: BOOL

Если функция выполнена успешно, возвращаемое значение ненулевое.

Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError. GetLastError может возвращать одну из следующих ошибок.

Возвращаемый код	Описание
ERROR_ACCESS_DENIED	Доступ запрещен. требуется FAX_CONFIG_SET доступ.
ERROR_INVALID_DATA	Элемент guid Guid указанной структуры FAX_GLOBAL_ROUTING_INFO не соответствует установленному методу маршрутизации факсов.
ERROR_INVALID_PARAMETER	Один или оба параметра FaxHandle или RoutingInfo недопустимы.

Замечания

Приложение, например приложение администрирования службы факсов, оснастка консоли управления Майкрософт (MMC), который управляет указанным методом маршрутизации факсов, обычно вызывает функцию FaxSetGlobalRoutingInfo.

Чтобы получить текущую глобальную конфигурацию, вызовите функцию FaxEnumGlobalRoutingInfo. Вызовите функцию FaxEnumRoutingMethods, чтобы перечислить методы маршрутизации факсов, связанные с определенным устройством. Дополнительные сведения см. в разделе Управление данными маршрутизации факсов.

Заметка

Заголовок winfax.h определяет FaxSetGlobalRoutingInfo как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winfax.h
библиотеки	WinFax.lib

См. также

FAX_GLOBAL_ROUTING_INFO

Функции API клиента службы факсов

API клиента службы факсов для Windows 2000

FaxEnumGlobalRoutingInfo

ФаксEnumRoutingMethods

Поделиться через