ISCPSecureQuery2::MakeDecision2-Methode (mswmdm.h)
Die MakeDecision2-Methode bestimmt, ob der Anbieter für sichere Inhalte für den Inhalt verantwortlich ist, indem Daten untersucht werden, die Windows Media Geräte-Manager an diese Methode übergibt. Diese Methode bietet zwei Ausgabeparameter für die Fehlerbehandlung, einen Standardspeicherort zum Aktualisieren widerrufener Komponenten und ein Bitflag, das angibt, welche Komponenten widerrufen wurden.
Syntax
HRESULT MakeDecision2(
[in] UINT fuFlags,
[in] BYTE *pData,
[in] DWORD dwSize,
[in] DWORD dwAppSec,
[in] BYTE *pbSPSessionKey,
[in] DWORD dwSessionKeyLen,
[in] IMDSPStorageGlobals *pStorageGlobals,
[in] BYTE *pAppCertApp,
[in] DWORD dwAppCertAppLen,
[in] BYTE *pAppCertSP,
[in] DWORD dwAppCertSPLen,
[in, out] LPWSTR *pszRevocationURL,
[in, out] DWORD *pdwRevocationURLLen,
[out] DWORD *pdwRevocationBitFlag,
[in, out] ULONGLONG *pqwFileSize,
[in] IUnknown *pUnknown,
[out] ISCPSecureExchange **ppExchange,
[in, out] BYTE [8] abMac
);
Parameter
[in] fuFlags
Flags, die die Daten beschreiben, die dem Anbieter für sichere Inhalte zum Treffen von Entscheidungen angeboten werden. Dieser Parameter muss im Authentifizierungscode für Eingabenachrichten enthalten sein. Ein oder mehrere der folgenden Flags können mithilfe eines bitweisen OR kombiniert werden.
| Flag | Beschreibung |
|---|---|
| WMDM_SCP_DECIDE_DATA | Der pData-Parameter verweist auf die zu untersuchenden Daten. |
| WMDM_MODE_TRANSFER_PROTECTED | Die Ausgabeobjektdaten der ISCPSecureExchange-Schnittstelle müssen geschützt werden. Wenn Windows Media Geräte-Manager keine oder beide Modusflags festlegt, entscheidet Windows Media Digital Rights Manager, ob die Ausgabeobjektdaten der ISCPSecureExchange-Schnittstelle geschützt oder nicht geschützt sein müssen. |
| WMDM_MODE_TRANSFER_UNPROTECTED | Die Ausgabeobjektdaten der ISCPSecureExchange-Schnittstelle müssen nicht geschützt sein. Wenn Windows Media Geräte-Manager keine oder beide Modusflags festlegt, entscheidet Windows Media Digital Rights Manager, ob die Ausgabeobjektdaten der ISCPSecureExchange-Schnittstelle geschützt oder nicht geschützt sein müssen. |
[in] pData
Zeiger auf ein Datenobjekt, das die zu untersuchenden Daten enthält. Dieser Parameter muss im Authentifizierungscode der Eingabenachricht enthalten sein und verschlüsselt werden.
[in] dwSize
DWORD mit der Größe der Dateidaten.
[in] dwAppSec
DWORD , das die Länge des dwAppSec-Members der WMDMRIGHTS-Struktur des zu untersuchenden Dienstanbieters und des sicheren Inhaltsanbieters in Bytes enthält. Dieser Parameter muss im Authentifizierungscode für Eingabenachrichten enthalten sein.
[in] pbSPSessionKey
Zeiger auf ein Array von Bytes, das den Sitzungsschlüssel enthält, um die Kommunikation mit dem Dienstanbieter zu schützen, auf den pStgGlobals verweist. Dieser Parameter muss im Authentifizierungscode der Eingabenachricht enthalten sein und verschlüsselt werden.
[in] dwSessionKeyLen
DWORD mit der Sitzungsschlüssellänge.
[in] pStorageGlobals
Zeiger auf die IWMDMStorageGlobals-Schnittstelle im Stammspeicher des Mediums oder Geräts, auf oder von dem die Datei übertragen wird. Dieser Parameter muss im Authentifizierungscode für Eingabenachrichten enthalten sein.
[in] pAppCertApp
Zeiger auf ein Anwendungszertifikat des Anwendungsobjekts.
[in] dwAppCertAppLen
DWORD , das die Länge des Anwendungszertifikats in Bytes enthält.
[in] pAppCertSP
Zeiger auf das Anwendungszertifikat des Dienstanbieterobjekts.
[in] dwAppCertSPLen
DWORD , das die Länge des Anwendungszertifikats in Bytes enthält.
[in, out] pszRevocationURL
Zeiger auf einen Puffer, der die Sperr-URL enthält.
[in, out] pdwRevocationURLLen
Zeiger auf ein DWORD , das die Größe des puffers rpszRevocationURL in Bytes enthält.
[out] pdwRevocationBitFlag
Zeiger auf ein DWORD,das das Sperrbitflag enthält. Der Flagwert ist entweder 0 oder mindestens einer der folgenden Flagnamen, die mithilfe eines bitweisen OR kombiniert werden.
| Wert | BESCHREIBUNG |
|---|---|
| WMDM_WMDM_REVOKED | Windows Media Geräte-Manager selbst wurde widerrufen. |
| WMDM_APP_REVOKED | Die Anwendung wurde widerrufen und muss aktualisiert werden, bevor DRM-geschützte Inhalte übertragen werden können. |
| WMDM_SP_REVOKED | Der Dienstanbieter wurde widerrufen und muss aktualisiert werden, bevor DRM-geschützte Inhalte an ihn übertragen werden können. |
| WMDM_SCP_REVOKED | Der Anbieter für sichere Inhalte wurde widerrufen und muss aktualisiert werden, bevor DRM-geschützte Inhalte übertragen werden können. |
[in, out] pqwFileSize
Zeiger auf eine QWORD-Datei , die die Dateigröße enthält. Der Anbieter für sichere Inhalte ist dafür verantwortlich, diesen Wert zu aktualisieren oder auf Null festzulegen, wenn die Größe der Zieldatei zu diesem Zeitpunkt nicht bestimmt werden kann.
[in] pUnknown
Zeiger auf eine unbekannte Schnittstelle aus der Anwendung.
[out] ppExchange
Zeiger auf ein Exchange-Objekt, das die Exchange-Schnittstelle empfängt.
[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
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, wird ein HRESULT-Fehlercode zurückgegeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Das Anwendungszertifikat, das der Anbieter für sichere Inhalte verwendet, um mit dem DRM-Client zu kommunizieren, wurde widerrufen. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |