ISCPSecureQuery::GetDataDemands-Methode (mswmdm.h)
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 |
---|---|
|
Der Nachrichtenauthentifizierungscode ist ungültig. |
|
Ein Parameter ist ein ungültiger oder NULL-Zeiger . |
|
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 |