IWMDRMSecurity::P erformSecurityUpdate-Methode

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]

Die Updateoption wird als eines der folgenden Flags ausgedrückt.

Flag Beschreibung
WMDRM _ SECURITY _ PERFORM _ INDIV Bewirkt, dass die DRM-Komponente nur 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.

Hinweise

Diese Methode wird asynchron ausgeführt. Sie gibt sofort nach dem Aufruf zurück und generiert dann Ereignisse, die vom im dwFlags-Parameter festgelegten Flag abhängen.

Für die Individualisierung (Flag auf WMDRM _ SECURITY _ PERFORM _ INDIV oder WMDRM _ SECURITY PERFORM FORCE _ _ _ INDIV festgelegt) 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 "POINTERMediaEvent::GetValue" abgerufen wird, ist ein IUnknown-Zeiger. Sie können die QueryInterface-Methode der abgerufenen IUnknown-Schnittstelle aufrufen, um eine Instanz 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 abschließt, 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 MEDIA DRM-Client-APIs Windows finden Sie unter Verwenden des Media Foundation Ereignismodells.

Anforderungen

Anforderung Wert
Header
Wmdrmsdk.h
Bibliothek
Wmdrmsdk.lib

Siehe auch

Automatisiertes Widerrufen und Erneuern von Komponenten

Beispiel für die DRM-Individualisierung

IWMDRMSecurity-Schnittstelle

Durchführen der DRM-Individualisierung