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

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Wsdbase.h (include Windows.h)

See also

WSD_SECURITY_CERT_VALIDATION
WSDCreateDeviceHost2
WSDCreateDeviceProxy2

 

 

Community Additions

ADD
Show: