ISCPSecureQuery::GetDataDemands-Methode (mswmdm.h)

Artikel
08/25/2023

Die GetDataDemands-Methode meldet, welche Daten der Anbieter für sichere Inhalte benötigt, um die Rechte und die Verantwortung für einen bestimmten Inhalt zu bestimmen.

Syntax

HRESULT GetDataDemands(
  [out]     UINT     *pfuFlags,
  [out]     DWORD    *pdwMinRightsData,
  [out]     DWORD    *pdwMinExamineData,
  [out]     DWORD    *pdwMinDecideData,
  [in, out] BYTE [8] abMac
);

Parameter

[out] pfuFlags

Flags, die die Daten beschreiben, die vom Anbieter für sichere Inhalte benötigt werden, um Entscheidungen zu treffen. Dieser Parameter ist im Authentifizierungscode der Ausgabenachricht enthalten. Es muss mindestens eines der folgenden Flags verwendet werden.

Flag	Beschreibung
WMDM_SCP_RIGHTS_DATA	Der Anbieter für sichere Inhalte benötigt Daten, um die Rechte für den Inhalt zu bestimmen.
WMDM_SCP_EXAMINE_DATA	Der Anbieter sicherer Inhalte benötigt Daten, um zu bestimmen, ob er für den Inhalt verantwortlich ist.
WMDM_SCP_DECIDE_DATA	Der Anbieter sicherer Inhalte benötigt Daten, um zu bestimmen, ob der Inhalt heruntergeladen werden kann.
WMDM_SCP_EXAMINE_EXTENSION	Der Anbieter für sichere Inhalte muss die Dateinamenerweiterung untersuchen, um zu bestimmen, ob der Inhalt heruntergeladen werden kann.
WMDM_SCP_PROTECTED_OUTPUT	Der Anbieter für sichere Inhalte benötigt eine geschützte Ausgabe.
WMDM_SCP_UNPROTECTED_OUTPUT	Der Anbieter für sichere Inhalte benötigt eine ungeschützte Ausgabe.

[out] pdwMinRightsData

Zeiger auf eine DWORD-Datei , die die Mindestmenge an Daten angibt, die zum Bestimmen der Rechte für diesen Inhalt erforderlich sind. Dieser Parameter ist im Authentifizierungscode der Ausgabenachricht enthalten.

[out] pdwMinExamineData

Zeiger auf ein DWORD mit der Mindestanzahl von Datenbytes, die der Anbieter für sichere Inhalte benötigt, um zu bestimmen, ob er für den Inhalt verantwortlich ist. Dieser Parameter ist im Authentifizierungscode der Ausgabenachricht enthalten.

[out] pdwMinDecideData

Zeiger auf ein DWORD , das die minimale Anzahl von Datenbytes enthält, die der Anbieter für sichere Inhalte benötigt, um zu bestimmen, ob der Inhalt heruntergeladen werden kann. Dieser Parameter ist im Authentifizierungscode der Ausgabenachricht enthalten.

[in, out] abMac

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

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabecode	Beschreibung
WMDM_E_MAC_CHECK_FAILED	Der Nachrichtenauthentifizierungscode ist ungültig.
E_INVALIDARG	Ein Parameter ist ein ungültiger oder NULL-Zeiger .
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Diese Methode muss aufgerufen werden, bevor eine der anderen Methoden von ISCPSecureQuery aufgerufen wird.

Diese Methode wird aufgerufen, nachdem alle Zertifikataustausche erfolgreich abgeschlossen wurden. Der Anbieter für sichere Inhalte füllt die Parameter mit den Flags und Daten aus, die seine Anforderungen zum Treffen von Entscheidungen über den Inhalt beschreiben.

Wenn der Anbieter für sichere Inhalte das flag WMDM_SCP_RIGHTS_DATA festlegt, sendet Windows Media Geräte-Manager die in pdwMinRightsData angegebene Datenmenge durch Aufrufen von ISCPSecureQuery::GetRights.

Wenn der Anbieter für sichere Inhalte das flag WMDM_SCP_EXAMINE_DATA festlegt, sendet Windows Media Geräte-Manager die in pdwMinExamineData angegebene Datenmenge durch Aufrufen von ISCPSecureQuery::ExamineData.

Wenn der Anbieter für sichere Inhalte das flag WMDM_SCP_DECIDE_DATA festlegt, sendet Windows Media Geräte-Manager die in pdwMinDecideData angegebene Datenmenge durch Aufrufen von ISCPSecureQuery::MakeDecision.

Wenn keine Prüfflags festgelegt sind, führt Windows Media Geräte-Manager keine weiteren Aufrufe aus. Wenn keine Entscheidungsflags festgelegt sind, ruft Windows Media Geräte-Manager weiterhin ISCPSecureQuery::ExamineData auf.

Wenn diese Methode nicht S_OK 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