IWMDRMSecurity::GetContentEnablersForRevocations-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 GetContentEnablersForRevocations-Methode ruft Inhaltsaktivierungsschnittstellen ab, die die Erneuerung von Komponenten basierend auf widerrufenen Zertifikaten ermöglichen.

Syntax

HRESULT GetContentEnablersForRevocations(
  [in]      BYTE              **rgpbCerts,
  [in]      DWORD             *rgpdwCertSizes,
  [in]      GUID              **rgpguidCerts,
  [in]      DWORD             cCerts,
  [in]      HRESULT           hResultHint,
  [out]     IMFContentEnabler **prgContentEnablers,
  [in, out] DWORD             *pcContentEnablers
);

Parameter

rgpbCerts [in]

Array von Zertifikaten, für die Inhaltsaktivierer abgerufen werden sollen. Die Anzahl der Elemente im Array muss von cCerts angegeben werden.

rgpdwCertSizes [in]

Array, das die Größen der Zertifikate im rgpbCerts-Array enthält. Die Anzahl der Elemente im Array muss von cCerts angegeben werden.

rgpguidCerts [in]

Array mit den Zertifikattypen im rgpbCerts-Array . Die Anzahl der Elemente im Array muss von cCerts angegeben werden. Verwenden Sie für jedes Element des Arrays einen der folgenden Werte.

GUID-Konstante	BESCHREIBUNG
WMDRM_REVOCATIONTYPE_APP	Gibt ein Anwendungszertifikat an.
WMDRM_REVOCATIONTYPE_DEVICE	Gibt ein Gerätezertifikat an.
WMDRM_REVOCATIONTYPE_CARDEA	Gibt ein Windows Media DRM für Netzwerkgerätezertifikat an.

cCerts [in]

Anzahl der Zertifikate, für die Inhaltsaktivierer abgerufen werden sollen. Dies ist die Anzahl der Elemente im rgpbCerts-Array , im rgpdwCertSizes-Array und im rgpguidCerts-Array .

hResultHint [in]

Gibt den Wert zurück, der von dem Vorgang empfangen wurde, der aufgrund eines widerrufenen Zertifikats fehlgeschlagen ist. Wenn Sie als Antwort auf einen fehlgeschlagenen Methodenaufruf nicht aufrufen, legen Sie auf S_OK fest.

prgContentEnablers [out]

Array, das die Adressen der neu erstellten IMFContentEnabler-Schnittstellen empfängt. Legen Sie auf NULL fest, um die Anzahl der Inhaltsaktivierer im pcContentEnablers-Parameter abzurufen.

pcContentEnablers [in, out]

Anzahl der Elemente im Array prgContentEnablers . Wenn prgContentEnablersNULL ist, wird dieser Wert auf die Anzahl der erforderlichen Inhaltsaktivierer für die Ausgabe festgelegt.

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.

Bemerkungen

Wenn Sie die IMFContentEnabler-Schnittstelle verwenden, um widerrufene Komponenten zu verlängern, müssen Sie den Prozess für den Benutzer klären. Diese Klarstellung muss erfolgen, da der Aktualisierungsprozess Informationen vom Clientcomputer an eine Microsoft-Website sendet.

Wenn Sie IMFContentEnabler::AutomaticEnable aufrufen, startet der Inhaltsaktivierer den Standardbrowser mit der Adresse des Updatediensts auf der Microsoft-Website. Ein eindeutiger Bezeichner, der die widerrufene Komponente identifiziert, wird an den Updatedienst gesendet. Der Dienst leitet den Browser dann zu einer Webseite um, von der der Benutzer möglicherweise die neue Version der widerrufenen Komponente herunterladen und installieren kann.

Anforderungen

Anforderung	Wert
Header	Wmdrmsdk.h
Bibliothek	Wmdrmsdk.lib

Siehe auch

Automatisiertes Sperren und Erneuern von Komponenten

IWMDRMSecurity-Schnittstelle