WSD_SECURITY_CERT_VALIDATION_V1 structure

Represents the criteria for matching client certificates against those of an HTTPS server.

Note  

Do not implement this structure directly; implementing WSD_SECURITY_CERT_VALIDATION instead ensures that the proper structure version is used, based on the Windows platform the application code is compiled on.

Syntax

typedef struct _WSD_SECURITY_CERT_VALIDATION_V1 {
  struct  WSD_SECURITY_CERT_VALIDATION;
  LPCWSTR pszCNGHashAlgId;
  BYTE    *pbCertHash;
  DWORD   dwCertHashSize;
} WSD_SECURITY_CERT_VALIDATION_V1, *PWSD_SECURITY_CERT_VALIDATION_V1;

Members

• WSD_SECURITY_CERT_VALIDATION
  The default WSD_SECURITY_CERT_VALIDATION structure.

• pszCNGHashAlgId
  The ID of the algorithm used to generate the client certificate hash.

• pbCertHash
  Pointer to a buffer containing the client certificate hash. The buffer can be freed by the application as soon as WSDCreateDeviceHost2 or WSDCreateDeviceProxy2 return success; WSDAPI generates an internal copy of the buffer.

• dwCertHashSize
  Indicates the length of pbCertHash.

Remarks

If the application is built using the Windows 8 SDK, targeted for Windows 8, WSD_SECURITY_CERT_VALIDATION resolves as WSD_SECURITY_CERT_VALIDATION_V1. The application can then only run on Windows 8 machines.

However, if the application is built using Windows 8 SDK, but targeted for Windows 7, WSD_SECURITY_CERT_VALIDATION will resolve to the old structure. While it's a given that the application will be supported for Windows 7, Windows 8 will also support the application as wsdapi.dll on Windows 8 will handle both the old and the newer versions of this structure. For example, an application developed with the Windows 7 SDK will run fine on Windows 8 machines.

Requirements

See also

WSD_SECURITY_CERT_VALIDATION

WSDCreateDeviceHost2

WSDCreateDeviceProxy2