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


структура WINHTTP_CREDS_EX (winhttp.h)

Структура WINHTTP_CREDS_EX содержит сведения об учетных данных пользователя, используемых для проверки подлинности сервера и прокси-сервера.

Синтаксис

typedef struct tagWINHTTP_CREDS_EX {
  LPSTR lpszUserName;
  LPSTR lpszPassword;
  LPSTR lpszRealm;
  DWORD dwAuthScheme;
  LPSTR lpszHostName;
  DWORD dwPort;
  LPSTR lpszUrl;
} WINHTTP_CREDS_EX, *PWINHTTP_CREDS_EX;

Члены

lpszUserName

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

lpszPassword

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

lpszRealm

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

dwAuthScheme

Флаг, содержащий схему проверки подлинности в качестве одного из следующих значений.

Значение Значение
WINHTTP_AUTH_SCHEME_BASIC
Используйте обычную проверку подлинности.
WINHTTP_AUTH_SCHEME_NTLM
Используйте проверку подлинности NTLM.
INHTTP_AUTH_SCHEME_DIGEST
Используйте дайджест-проверку подлинности.
WINHTTP_AUTH_SCHEME_NEGOTIATE
Выберите между проверками подлинности NTLM и Kerberos.

lpszHostName

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

dwPort

Порт подключения к серверу.

lpszUrl

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

Комментарии

Эта структура используется с параметрами WINHTTP_OPTION_GLOBAL_SERVER_CREDS и флагами WINHTTP_OPTION_GLOBAL_PROXY_CREDSпараметров. Для этих параметров требуется раздел реестра HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings\ShareCredsWithWinHttp. Этот раздел реестра отсутствует по умолчанию.

Если он задан, WinINet отправит учетные данные в WinHTTP. Всякий раз, когда WinHttp получает запрос проверки подлинности, и если учетные данные не заданы для текущего дескриптора, он будет использовать учетные данные, предоставленные WinINet. Чтобы предоставить общий доступ к учетным данным сервера в дополнение к учетным данным прокси-сервера, пользователям необходимо установить флаг параметра WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS .

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть winhttp.h

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

WINHTTP_CREDS