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


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

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

Функция WlxQueryClientCredentials вызывается с помощью замены библиотеки DLL GINA, если включены службы терминалов.

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

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

Синтаксис

PWLX_QUERY_CLIENT_CREDENTIALS PwlxQueryClientCredentials;

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

Параметры

[out] pCred

Указывает указатель на структуру WLX_CLIENT_CREDENTIALS_INFO_V1_0 , содержащую учетные данные клиента при возврате.

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

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

Код возврата Описание
TRUE
Учетные данные были извлечены и возвращены в pCred.
FALSE
Учетные данные не были получены.

Комментарии

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

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

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

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

Требования

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

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

WLX_DISPATCH_VERSION_1_3

WlxDisconnect

WlxNegotiate

WlxQueryInetConnectorCredentials

WlxWin31Migrate