Share via

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

  • Статья

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

Примечание Эта структура является нерекомендуемой. Вместо этого рекомендуется использовать структуру WINHTTP_CREDS_EX .
 

Синтаксис

typedef struct tagWINHTTP_CREDS {
  LPSTR lpszUserName;
  LPSTR lpszPassword;
  LPSTR lpszRealm;
  DWORD dwAuthScheme;
  LPSTR lpszHostName;
  DWORD dwPort;
} WINHTTP_CREDS, *PWINHTTP_CREDS;

Члены

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

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

Комментарии

Эта структура используется с параметрами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_EX