IWMDRMSecurity::GetMachineCertificate method
[The feature associated with this page, Windows Media Format 11 SDK, is a legacy feature. It has been superseded by Source Reader and Sink Writer. Source Reader and Sink Writer have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Source Reader and Sink Writer instead of Windows Media Format 11 SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The GetMachineCertificate method retrieves the machine certificate of the DRM subsystem on the client computer.
Syntax
HRESULT GetMachineCertificate(
[in] DWORD dwCertificateType,
[out] BYTE rgbVersion[4],
[out] BYTE **ppbCertificate,
[in, out] DWORD *pcbCertificate
);
Parameters
-
dwCertificateType [in]
-
Type of certificate to retrieve. Set to one of the values in the following table.
Value Description WMDRM_CERTIFICATE_TYPE_V1 The certificate will be retrieved in the format used by legacy components. WMDRM_CERTIFICATE_TYPE_V2 The certificate will be retrieved in the format used by the Windows Vista components. -
rgbVersion[4] [out]
-
Array of four bytes specifying the version of the DRM subsystem on the client computer.
-
ppbCertificate [out]
-
Address of a variable that receives a pointer to the certificate data. Set to NULL to have the method provide the buffer size required to hold the certificate in pcbCertificate.
-
pcbCertificate [in, out]
-
Size of the certificate in bytes. If ppbCertificate is NULL, this value will be set to the size of the certificate. If ppbCertificate is not NULL, this value must be set to the size of the buffer.
Return value
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
| Return code | Description |
|---|---|
|
The method succeeded. |
Requirements
| Requirement | Value |
|---|---|
| Header |
|
| Library |
|