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