Функция DdeSetQualityOfService (dde.h)

Статья
08/23/2023

Указывает качество обслуживания (QOS) для необработанного приложения динамического обмена данными (DDE) для будущих диалогов DDE, которые оно инициирует. Указанный QOS применяется ко всем беседам, начатым при наличии этих параметров. Качество обслуживания беседы DDE сохраняется в течение всего диалога; Вызовы функции DdeSetQualityOfService во время беседы не влияют на качество обслуживания этого диалога.

Синтаксис

BOOL DdeSetQualityOfService(
  [in]  HWND                              hwndClient,
  [in]  const SECURITY_QUALITY_OF_SERVICE *pqosNew,
  [out] PSECURITY_QUALITY_OF_SERVICE      pqosPrev
);

Параметры

[in] hwndClient

Тип: HWND

Дескриптор окна клиента DDE, указывающий источник WM_DDE_INITIATE сообщений, отправляемых клиентом для запуска бесед DDE.

[in] pqosNew

Тип: const SECURITY_QUALITY_OF_SERVICE*

Указатель на структуру SECURITY_QUALITY_OF_SERVICE для требуемого качества обслуживания.

[out] pqosPrev

Тип: PSECURITY_QUALITY_OF_SERVICE

Указатель на структуру SECURITY_QUALITY_OF_SERVICE , которая получает предыдущие значения качества обслуживания, связанные с окном, определенным hwndClient.

Этот параметр является необязательным. Если приложение не заинтересовано в предыдущих значениях QOS hwndClient, оно должно задать для pqosPrevзначение NULL.

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

Тип: BOOL

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

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

Если качество обслуживания не было указано для клиентского окна hwndClient перед отправкой WM_DDE_INITIATE с wParam , для которого задано значение hwndClient, система использует следующие значения качества обслуживания по умолчанию для клиентского окна:

{ 
   Length = sizeof(SECURITY_QUALITY_OF_SERVICE); 
   ImpersonationLevel = SecurityImpersonation; 
   ContextTrackingMode = SECURITY_STATIC_TRACKING; 
   EffectiveOnly = TRUE; 
}

Используйте функцию DdeSetQualityOfService , чтобы связать другое качество обслуживания с окном клиента. После изменения качества обслуживания новые параметры влияют на все последующие диалоги, которые будут запущены. Когда приложение запускает беседу DDE, используя определенное значение качества обслуживания, оно должно завершить беседу и перезапустить беседу, чтобы ввести в силу другое значение.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	dde.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll