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 |
|---|---|
|
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 |
|
| Bibliothek |
|