Edit

HTTP_SSL_INFO structure (http.h)

  • Article

The HTTP_SSL_INFO structure contains data for a connection that uses Secure Sockets Layer (SSL), obtained through the SSL handshake.

Syntax

typedef struct _HTTP_SSL_INFO {
  USHORT                     ServerCertKeySize;
  USHORT                     ConnectionKeySize;
  ULONG                      ServerCertIssuerSize;
  ULONG                      ServerCertSubjectSize;
  PCSTR                      pServerCertIssuer;
  PCSTR                      pServerCertSubject;
  PHTTP_SSL_CLIENT_CERT_INFO pClientCertInfo;
  ULONG                      SslClientCertNegotiated;
} HTTP_SSL_INFO, *PHTTP_SSL_INFO;

Members

ServerCertKeySize

The size, in bytes, of the public key used to sign the server certificate.

ConnectionKeySize

The size, in bytes, of the cipher key used to encrypt the current session.

ServerCertIssuerSize

The size, in bytes, of the string pointed to by the pServerCertIssuer member not including the terminating null character.

ServerCertSubjectSize

The size, in bytes, of the string pointed to by the pServerCertSubject member not including the terminating null character.

pServerCertIssuer

A pointer to a null-terminated string of octets that specifies the name of the entity that issued the certificate.

pServerCertSubject

A pointer to a null-terminated string of octets that specifies the name of the entity to which the certificate belongs.

pClientCertInfo

A pointer to an HTTP_SSL_CLIENT_CERT_INFO structure that specifies the client certificate.

SslClientCertNegotiated

If non-zero, indicates that the client certificate is already present locally.

Remarks

An HTTP_SSL_INFO structure can be pointed to by the pSslInfo member of an HTTP_REQUEST structure.

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header http.h

See also

HTTP Server API Version 1.0 Structures

HTTP_REQUEST

HTTP_SSL_CLIENT_CERT_INFO