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


функция обратного вызова PWLX_QUERY_IC_CREDENTIALS (winwlx.h)

[Функция WlxQueryInetConnectorCredentials больше не доступна для использования с Windows Server 2008 и Windows Vista.]

Вызывается с помощью замены библиотеки DLL GINA, если включены службы терминалов. GINA вызывает эту функцию, чтобы определить, использует ли сервер терминалов лицензирование соединителя Через Интернет, и получить сведения об учетных данных .

Примечание Библиотеки DLL GINA игнорируются в Windows Vista.
 
Библиотека DLL GINA может использовать эти сведения для автоматического заполнения поля входа и попытки входа пользователя в систему.

Синтаксис

PWLX_QUERY_IC_CREDENTIALS PwlxQueryIcCredentials;

BOOL PwlxQueryIcCredentials(
  [out] PWLX_CLIENT_CREDENTIALS_INFO_V1_0 pCred
)
{...}

Параметры

[out] pCred

Если возвращаемое значение равно TRUE, pCred указывает указатель на структуру WLX_CLIENT_CREDENTIALS_INFO_V1_0 , содержащую учетные данные, используемые для автоматического входа.

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

Функция WlxQueryInetConnectorCredentials возвращает одно из следующих значений.

Код возврата Описание
TRUE
Лицензирование соединителя Интернета включено.
FALSE
Лицензирование соединителя Через Интернет недоступно.

Комментарии

Библиотека DLL GINA отвечает за вызов LocalFree для освобождения ресурсов, используемых этой структурой, когда структура больше не нужна.

Чтобы получить доступ к этой функции, библиотека DLL GINA должна использовать структуру WLX_DISPATCH_VERSION_1_3 и задать для версии Winlogon по крайней мере WLX_VERSION_1_3 в вызове WlxNegotiate .

Если службы терминалов не используют лицензию на соединитель Через Интернет, библиотека DLL GINA должна вызывать WlxQueryClientCredentials.

Другие функции поддержки Winlogon, которые могут вызываться при включении служб терминалов: WlxDisconnect, WlxQueryClientCredentials, WlxQueryTerminalServicesData и WlxWin31Migrate.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header winwlx.h

См. также раздел

WLX_DISPATCH_VERSION_1_3

WlxDisconnect

WlxNegotiate

WlxQueryClientCredentials

WlxWin31Migrate