ISCPSecureQuery3::MakeDecisionOnClearChannel-Methode (mswmdm.h)

Artikel
08/25/2023

Die MakeDecisionOnClearChannel-Methode bestimmt, ob der Zugriff auf den Inhalt für einen clear-Kanal zulässig ist. Wenn der Zugriff zulässig ist, gibt diese Methode die Schnittstelle zurück, die für den Zugriff auf den Inhalt verwendet wird.

Syntax

HRESULT MakeDecisionOnClearChannel(
  [in]      UINT                fuFlags,
  [in]      BYTE                *pData,
  [in]      DWORD               dwSize,
  [in]      DWORD               dwAppSec,
  [in]      BYTE                *pbSPSessionKey,
  [in]      DWORD               dwSessionKeyLen,
  [in]      IMDSPStorageGlobals *pStorageGlobals,
  [in]      IWMDMProgress3      *pProgressCallback,
  [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
);

Parameter

[in] fuFlags

Flags, die die Daten beschreiben, die dem Inhaltsanbieter zum Treffen von Entscheidungen angeboten werden. Die folgenden Flags können vorhanden sein.

Flag	Beschreibung
WMDM_SCP_DECIDE_DATA	Der pData-Parameter verweist auf zu untersuchende 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 drM (Digital Rights Management), 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 drM (Digital Rights Management), 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.

[in] dwSize

DWORD , das die Länge der zu untersuchenden Daten in Bytes enthält.

[in] dwAppSec

DWORD, das die aktuelle Sicherheitsstufe von Windows Media Geräte-Manager angibt. Dies ist die kleinere der aktuellen Sicherheitsstufen der Anwendung und des Zieldienstanbieters.

[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.

[in] dwSessionKeyLen

Länge des Bytearrays, auf das pbSPSessionKey verweist.

[in] pStorageGlobals

Zeiger auf die IWMDMStorageGlobals-Schnittstelle im Stammspeicher des Mediums oder Geräts, auf oder von dem die Datei übertragen wird.

[in] pProgressCallback

Zeiger auf ein Statusrückrufobjekt.

[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 null 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 Inhaltsanbieter 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 Inhaltsanbieter 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.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Fehlercode zurück.

Rückgabecode	Beschreibung
WMDM_E_CALL_OUT_OF_SEQUENCE	Diese Methode wurde aus der Sequenz heraus aufgerufen.
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 pdwMinDecisionData-Parameter in der ISCPSecureQuery::GetDataDemands-Methode bestimmt.
S_FALSE	Der Aufrufer verfügt nicht über die erforderlichen Rechte, um die angeforderte Übertragung durchzuführen.
E_INVALIDARG	Ein Parameter ist ungültig oder ein NULL-Zeiger .
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Diese Methode ist identisch mit ISCPSecureQuery2::MakeDecision2 , mit der Ausnahme, dass die an diese Methode übergebenen Parameter nicht verschlüsselt sind. Daher ist diese Methode effizienter.

Anforderungen

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

Weitere Informationen

ISCPSecureQuery2::MakeDecision2

ISCPSecureQuery3-Schnittstelle

Freigeben über