Compartir a través de

estructura WINHTTP_CREDS_EX (winhttp.h)

  • Artículo

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

Sintaxis

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;

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.

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.

lpszUrl

Puntero a un búfer que contiene la dirección URL de destino.

Comentarios

Esta estructura se usa con opciones WINHTTP_OPTION_GLOBAL_SERVER_CREDS y marcasde opción WINHTTP_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

   
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