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 関数に渡された dwOption パラメーターが WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT に設定されている場合、WinHttpQueryOption 関数はWINHTTP_CERTIFICATE_INFO構造体を返します。 詳細については、「 オプション フラグ」を参照してください。

WinHttpQueryOption 関数は、WINHTTP_CERTIFICATE_INFO構造体の lpszProtocolName、lpszSignatureAlgName、lpszEncryptionAlgName メンバーを設定しないため、これらのメンバーは常に NULL として返されます。

返された WINHTTP_CERTIFICATE_INFO 構造体がアプリケーションで不要になったら、 LocalFree 関数を呼び出して、構造体で返されるポインターを解放する必要があります。 NULL ではなく解放する必要があるポインターを含む構造体メンバーは、 lpszSubjectInfo と lpszIssuerInfo です。

要件

こちらもご覧ください

オプション フラグ

WinHTTP バージョン

WinHttpQueryOption