IWMDRMSecurity::GetContentEnablersFromHashes-Methode

Artikel
06/21/2023

[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 GetContentEnablersFromHashes-Methode ruft Inhaltsaktivierungsschnittstellen ab, die die Erneuerung von Komponenten basierend auf Hashzertifikaten ermöglichen.

Syntax

HRESULT GetContentEnablersFromHashes(
  [in]      BSTR              *rgpbCertHashes,
  [in]      DWORD             cCerts,
  [in]      HRESULT           hResultHint,
  [out]     IMFContentEnabler **prgContentEnablers,
  [in, out] DWORD             *pcContentEnablers
);

Parameter

rgpbCertHashes [in]: Array von Zertifikathashes, für die Inhaltsaktivierer abgerufen werden sollen.
cCerts [in]: Anzahl der Zertifikate, für die Inhaltsaktivierer abgerufen werden sollen. Dies ist die Anzahl der Elemente im rgpbCertHashes-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

IWMDRMSecurity-Schnittstelle