ISCPSecureQuery::ExamineData-Methode (mswmdm.h)

Artikel
08/25/2023

Die ExamineData-Methode bestimmt die Rechte und die Verantwortung für den Inhalt, indem Daten untersucht werden, die Windows Media Geräte-Manager an diese Methode übergibt.

Syntax

HRESULT ExamineData(
  [in]      UINT     fuFlags,
  [in]      LPWSTR   pwszExtension,
  [in]      BYTE     *pData,
  [in]      DWORD    dwSize,
  [in, out] BYTE [8] abMac
);

Parameter

[in] fuFlags

Flags, die die Daten beschreiben, die dem Anbieter für sichere Inhalte zur Entscheidungsfindung angeboten werden. Die folgenden Flags können vorhanden sein.

Flag	Beschreibung
WMDM_SCP_EXAMINE_DATA	Der pData-Parameter verweist auf zu untersuchende Daten.

[in] pwszExtension

Zeiger auf die zu überprüfende Dateinamenerweiterung, wenn der Anbieter für sichere Inhalte im Aufruf "GetDataDemands " nach einer Erweiterung fragt.

[in] pData

Zeiger auf die Daten am Anfang der zu untersuchenden Datei. Dieser Parameter muss im Authentifizierungscode der Eingabenachricht enthalten sein und verschlüsselt werden.

[in] dwSize

DWORD , das die Länge der zu untersuchenden Daten in Bytes enthält. Dieser Parameter muss im Authentifizierungscode für Eingabenachrichten enthalten sein.

[in, out] abMac

Array von acht Bytes, die den Nachrichtenauthentifizierungscode für die Parameterdaten dieser Methode enthalten. (WMDM_MAC_LENGTH ist als 8 definiert.)

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. Der Anbieter für sichere Inhalte ist für diese Inhalte verantwortlich.
WMDM_E_CALL_OUT_OF_SEQUENCE	Diese Methode wurde aus der Sequenz heraus aufgerufen. GetDataDemands muss zuerst aufgerufen werden.
WMDM_E_MAC_CHECK_FAILED	Der Nachrichtenauthentifizierungscode ist ungültig.
WMDM_E_MOREDATA	Windows Media Geräte-Manager muss diese Methode mit einem anderen Datenpaket erneut aufrufen. Die Größe des Pakets wird durch den pdwMinExamineData-Parameter in der GetDataDemands-Methode bestimmt.
S_FALSE	Der Anbieter von sicheren Inhalten ist für diese Inhalte nicht verantwortlich. Beenden Sie die Interaktion mit dem anbieter für sichere Inhalte.
E_INVALIDARG	Ein Parameter ist ungültig oder ein NULL-Zeiger .
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Diese Methode wird nach der GetDataDemands-Methode aufgerufen. Der Anbieter für sichere Inhalte verwendet die in dieser Methode übergebenen Informationen, um zu bestimmen, ob er für den Inhalt verantwortlich ist. Der fuFlags-Parameter wird konsultiert, um festzustellen, welche Daten zur Prüfung vorgelegt wurden. Der pData-Parameter verweist auf den Anfang der Rechte- und Verantwortungsdaten. Der dwSize-Parameter enthält die Länge der Rechte- und Verantwortungsdaten in Bytes.

Wenn das WMDM_SCP_EXAMINE_DATA-Flag festgelegt ist, enthält der pDataBuffer-ParameterdwDataLength von Bytes für den zu untersuchenden Sicheren Inhaltsanbieter.

Wenn diese Methode S_OK oder WMDM_E_MOREDATA nicht zurückgibt, führt Windows Media Geräte-Manager keine weiteren Aufrufe an diesen anbieter für sichere Inhalte durch.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	mswmdm.h
Bibliothek	Mssachlp.lib

Weitere Informationen

ISCPSecureQuery-Schnittstelle

Freigeben über