IWMDRMSecurity::GetMachineCertificate-Methode

[Das dieser Seite zugeordnete Feature Windows Media Format 11 SDK ist ein Legacyfeature. Sie wurde durch den Quellleser und den Senkenschreiber ersetzt. Quellleser und Senkenschreiber wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit den Quellleser und senkenden Writer anstelle des Windows Media Format 11 SDK verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die GetMachineCertificate-Methode ruft das Computerzertifikat des DRM-Subsystems auf dem Clientcomputer ab.

Syntax

HRESULT GetMachineCertificate(
  [in]      DWORD dwCertificateType,
  [out]     BYTE  rgbVersion[4],
  [out]     BYTE  **ppbCertificate,
  [in, out] DWORD *pcbCertificate
);

Parameter

dwCertificateType [in]

Typ des abzurufenden Zertifikats. Legen Sie einen der Werte in der folgenden Tabelle fest.

Wert	BESCHREIBUNG
WMDRM_CERTIFICATE_TYPE_V1	Das Zertifikat wird in dem Format abgerufen, das von Legacykomponenten verwendet wird.
WMDRM_CERTIFICATE_TYPE_V2	Das Zertifikat wird in dem Format abgerufen, das von den Windows Vista-Komponenten verwendet wird.

rgbVersion[4] [out]

Array von vier Bytes, die die Version des DRM-Subsystems auf dem Clientcomputer angeben.

ppbCertificate [out]

Adresse einer Variablen, die einen Zeiger auf die Zertifikatdaten empfängt. Legen Sie auf NULL fest, damit die -Methode die Puffergröße bereitstellt, die zum Halten des Zertifikats in pcbCertificate erforderlich ist.

pcbCertificate [in, out]

Größe des Zertifikats in Bytes. Wenn ppbCertificateNULL ist, wird dieser Wert auf die Größe des Zertifikats festgelegt. Wenn ppbCertificate nicht NULL ist, muss dieser Wert auf die Größe des Puffers festgelegt werden.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.

Anforderungen

Anforderung	Wert
Header	Wmdrmsdk.h
Bibliothek	Wmdrmsdk.lib

Siehe auch

IWMDRMSecurity-Schnittstelle