WINHTTP_CERTIFICATE_INFO 구조체(winhttp.h)

WINHTTP_CERTIFICATE_INFO 구조에는 서버에서 반환된 인증서 정보가 포함됩니다. 이 구조체는 WinHttpQueryOption 함수에서 사용됩니다.

구문

typedef struct _WINHTTP_CERTIFICATE_INFO {
  FILETIME ftExpiry;
  FILETIME ftStart;
  LPWSTR   lpszSubjectInfo;
  LPWSTR   lpszIssuerInfo;
  LPWSTR   lpszProtocolName;
  LPWSTR   lpszSignatureAlgName;
  LPWSTR   lpszEncryptionAlgName;
  DWORD    dwKeySize;
} WINHTTP_CERTIFICATE_INFO, *PWINHTTP_CERTIFICATE_INFO;

멤버

ftExpiry

인증서가 만료되는 날짜를 포함하는 FILETIME 구조체입니다.

ftStart

인증서가 유효해지는 날짜를 포함하는 FILETIME 구조체입니다.

lpszSubjectInfo

인증서가 발급된 organization, 사이트 및 서버의 이름을 포함하는 버퍼에 대한 포인터입니다.

lpszIssuerInfo

인증서를 발급한 organization, 사이트 및 서버의 이름을 포함하는 버퍼에 대한 포인터입니다.

lpszProtocolName

보안 연결을 제공하는 데 사용되는 프로토콜의 이름을 포함하는 버퍼에 대한 포인터입니다. 이 멤버는 현재 사용되지 않습니다.

lpszSignatureAlgName

인증서에 서명하는 데 사용되는 알고리즘의 이름을 포함하는 버퍼에 대한 포인터입니다. 이 멤버는 현재 사용되지 않습니다.

lpszEncryptionAlgName

보안 채널(SSL/TLS) 연결을 통해 암호화를 수행하는 데 사용되는 알고리즘의 이름을 포함하는 버퍼에 대한 포인터입니다. 이 멤버는 현재 사용되지 않습니다.

dwKeySize

키의 크기(바이트)입니다.

설명

WINHTTP_CERTIFICATE_INFO 구조에는 연결에서 SSL/TLS를 사용할 때 서버에서 반환하는 인증서에 대한 정보가 포함됩니다. WinHttpQueryOption 함수는 WinHttpQueryOption 함수에 전달된 dwOption 매개 변수가 WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT 설정되면 WINHTTP_CERTIFICATE_INFO 구조를 반환합니다. 자세한 내용은 옵션 플래그를 참조하세요.

WinHttpQueryOption 함수는 WINHTTP_CERTIFICATE_INFO 구조체의 lpszProtocolName, lpszSignatureAlgName 및 lpszEncryptionAlgName 멤버를 설정하지 않으므로 이러한 멤버는 항상 NULL로 반환됩니다.

애플리케이션에 반환된 WINHTTP_CERTIFICATE_INFO 구조체가 더 이상 필요하지 않으면 LocalFree 함수를 호출하여 구조체에 반환된 포인터를 해제해야 합니다. NULL이 아니고 해제해야 하는 포인터가 포함된 구조체 멤버는 lpszSubjectInfo 및 lpszIssuerInfo입니다.

참고 Windows XP 및 Windows 2000의 경우 Windows HTTP 서비스 시작 페이지의 런타임 요구 사항 섹션을 참조하세요.

 

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP, Windows 2000 Professional SP3 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003, Windows 2000 Server SP3 [데스크톱 앱만 해당]
머리글	winhttp.h
재배포 가능 파일	Windows XP 및 Windows 2000에서 WinHTTP 5.0 및 인터넷 Explorer 5.01 이상.

추가 정보

옵션 플래그

WinHTTP 버전

WinHttpQueryOption