Share via

estructura WINHTTP_CREDS (winhttp.h)

  • Artículo

La estructura de WINHTTP_CREDS contiene información de credenciales de usuario usada para la autenticación de servidor y proxy.

Nota Esta estructura ha quedado en desuso. En su lugar, se recomienda el uso de la estructura WINHTTP_CREDS_EX .
 

Sintaxis

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

Miembros

lpszUserName

Puntero a un búfer que contiene el nombre de usuario.

lpszPassword

Puntero a un búfer que contiene la contraseña.

lpszRealm

Puntero a un búfer que contiene el dominio kerberos.

dwAuthScheme

Marca que contiene el esquema de autenticación, como uno de los valores siguientes.

Valor Significado
WINHTTP_AUTH_SCHEME_BASIC
 Use la autenticación básica.
WINHTTP_AUTH_SCHEME_NTLM
 Use la autenticación NTLM.
INHTTP_AUTH_SCHEME_DIGEST
 Use la autenticación implícita.
WINHTTP_AUTH_SCHEME_NEGOTIATE
 Seleccione entre la autenticación NTLM y Kerberos.

lpszHostName

Puntero a un búfer que contiene el nombre de host.

dwPort

Puerto de conexión del servidor.

Comentarios

Esta estructura se usa con opciones WINHTTP_OPTION_GLOBAL_SERVER_CREDS y marcas de opciónWINHTTP_OPTION_GLOBAL_PROXY_CREDS. Estas opciones requieren la clave del Registro HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings! ShareCredsWithWinHttp. Esta clave del Registro no está presente de forma predeterminada.

Cuando se establece, WinINet enviará las credenciales a WinHTTP. Cada vez que WinHttp obtiene un desafío de autenticación y si no hay credenciales establecidas en el identificador actual, usará las credenciales proporcionadas por WinINet. Para compartir las credenciales del servidor además de las credenciales de proxy, los usuarios deben establecer la marca de opción WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado winhttp.h

Consulte también

WINHTTP_CREDS_EX