IWMDRMSecurity::P erformSecurityUpdate-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 PerformSecurityUpdate-Methode initiiert ein Sicherheitsupdate für das DRM-Subsystem auf dem lokalen Computer.

Syntax

HRESULT PerformSecurityUpdate(
  [in]  DWORD    dwFlags,
  [out] IUnknown **ppunkCancelationCookie
);

Parameter

dwFlags [in]

Updateoption, ausgedrückt als eines der folgenden Flags.

Flag	Beschreibung
WMDRM_SECURITY_PERFORM_INDIV	Bewirkt, dass die DRM-Komponente nur dann individualisiert wird, wenn die Version des Clients veraltet ist.
WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH	Bewirkt, dass die Sperrlisten auf dem Clientcomputer aktualisiert werden.
WMDRM_SECURITY_PERFORM_FORCE_INDIV	Bewirkt, dass die DRM-Komponente individualisiert wird, auch wenn die Version des Clients auf dem neuesten Stand ist.

ppunkCancelationCookie [out]

Adresse einer Variablen, die einen Zeiger auf ein Objekt empfängt, das zum Abbrechen dieses Vorgangs verwendet werden kann.

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

Diese Methode wird asynchron ausgeführt. Es wird sofort nach dem Aufruf zurückgegeben und dann Ereignisse generiert, abhängig vom Flag, das im dwFlags-Parameter festgelegt ist.

Für die Individualisierung (flag set to WMDRM_SECURITY_PERFORM_INDIV or WMDRM_SECURITY_PERFORM_FORCE_INDIV) wird eine Reihe von MEWMDRMIndividualizationProgress-Ereignissen generiert, gefolgt von einem MEWMDRMIndividualizationCompleted-Ereignis , wenn die Verarbeitung abgeschlossen ist. Der Wert jedes MEWMDRMIndividualizationProgress-Ereignisses , das durch aufrufen von IMFMediaEvent::GetValue abgerufen wird, ist ein IUnknown-Zeiger . Sie können die QueryInterface-Methode der abgerufenen IUnknown-Schnittstelle aufrufen, um eine instance der IWMDRMIndividualizationStatus-Schnittstelle abzurufen.

Zum Aktualisieren der Sperrlisten (Flag auf WMDRM_SECURITY_PERFORM_REVOCATION_REFRESH festgelegt) wird nach Abschluss der Verarbeitung ein MEWMDRMREvocationDownloadCompleted-Ereignis generiert.

Hinweis

Wenn PerformSecurityUpdate die Individualisierung abgeschlossen hat, sind die einzigen vorhandenen Objekte, die den neuen individualisierten Zustand widerspiegeln, diejenigen, die von IWMDRMSecurity erben. Alle anderen vorhandenen Objekte werden nicht aktualisiert. Sie müssen alle anderen Objekte freigeben und neu erstellen, damit sie den neuen individualisierten Zustand widerspiegeln.

Weitere Informationen zur Verwendung der asynchronen Methoden der erweiterten Windows Media DRM-Client-APIs finden Sie unter Verwenden des Media Foundation-Ereignismodells.

Anforderungen

Anforderung	Wert
Header	Wmdrmsdk.h
Bibliothek	Wmdrmsdk.lib

Siehe auch

Automatisiertes Sperren und Erneuern von Komponenten

DRM-Einzelisierungsbeispiel

IWMDRMSecurity-Schnittstelle

Durchführen der DRM-Individualisierung