Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Gets the subject key ID of the certificate for a signed message.
Syntax
HRESULT GetKeyInfo(
[out] BYTE *pbKeyInfo,
[in, out] DWORD *pdwKeyInfoSize
);
Parameters
pbKeyInfo [out]
A pointer to a buffer that will be filled with the subject key ID for the certificate that signed the message.pdwKeyInfoSize [in, out]
On input, the size of pbKeyInfo in bytes. On output, pdwKeyInfoSize contains the actual size of the buffer that was written.
Return value
Possible return values include, but are not limited to, the following.
| Return code | Description |
|---|---|
| S_OK | Method succeeded. |
| E_NOTAVAIL | The message is not signed. |
| HRESULT_FROM_WIN32(ERROR_MORE_DATA) | pbKeyInfo is not large enough to hold the information. pdwKeyInfoSize now specifies the required buffer size. |
Remarks
The subject key ID is a hash of the certificate's public key and is used to uniquely identify a certificate.
If NULL is passed to pbKeyInfo, then GetKeyInfo will return the size of the buffer to allocate in the pdwKeyInfoSize parameter.
Requirements
Minimum supported client |
Windows 7 [desktop apps only] |
Minimum supported server |
Windows Server 2008 R2 [desktop apps only] |
Header |
Wsdbase.h (include Wsdapi.h) |
IDL |
Wsdbase.idl |
DLL |
Wsdapi.dll |