Freigeben über


ISCPSecureQuery3::GetRightsOnClearChannel-Methode (mswmdm.h)

Die GetRightsOnClearChannel-Methode ruft Rechteinformationen für den aktuellen Inhalt in einem clear-Kanal ab.

Syntax

HRESULT GetRightsOnClearChannel(
  [in]  BYTE                *pData,
  [in]  DWORD               dwSize,
  [in]  BYTE                *pbSPSessionKey,
  [in]  DWORD               dwSessionKeyLen,
  [in]  IMDSPStorageGlobals *pStgGlobals,
  [in]  IWMDMProgress3      *pProgressCallback,
  [out] PWMDMRIGHTS         *ppRights,
  [out] UINT                *pnRightsCount
);

Parameter

[in] pData

Zeiger auf das Datenobjekt.

[in] dwSize

Anzahl der Bytes der Daten im pData-Puffer .

[in] pbSPSessionKey

Zeiger auf ein Bytearray, das den Sitzungsschlüssel zum Sichern der Kommunikation mit dem Dienstanbieter enthält, auf den pStgGlobals verweist.

[in] dwSessionKeyLen

Länge des Bytearrays, auf das pbSPSessionKey verweist.

[in] pStgGlobals

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

[in] pProgressCallback

Zeiger auf eine IWMDMProgress3-Schnittstelle .

[out] ppRights

Zeiger auf ein Array von WMDMRIGHTS-Strukturen , die die Rechteinformationen für dieses Objekt enthalten. Das Array wird von dieser Methode zugeordnet und muss mithilfe von CoTaskMemFree freigegeben werden.

[out] pnRightsCount

Anzahl der WMDMRIGHTS-Strukturen im ppRights-Array .

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn die Methode fehlschlägt, wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabecode Beschreibung
WMDM_E_CALL_OUT_OF_SEQUENCE
Diese Methode wurde außerhalb der Reihenfolge aufgerufen. ISCPSecureQuery::GetDataDemands und dann ISCPSecureQuery::ExamineData müssen in dieser Reihenfolge aufgerufen werden.
WMDM_E_MAC_CHECK_FAILED
Der Nachrichtenauthentifizierungscode ist ungültig.
WMDM_E_NORIGHTS
Der Aufrufer verfügt nicht über die erforderlichen Rechte, um den angeforderten Vorgang auszufü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 ISCPSecureQuery::GetRights , mit der Ausnahme, dass die an diese Methode übergebenen Parameter nicht verschlüsselt sind. Folglich ist diese Methode effizienter.

Anforderungen

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

Weitere Informationen

ISCPSecureQuery3-Schnittstelle

ISCPSecureQuery::GetRights

IWMDMStorageGlobals-Schnittstelle

WMDMRIGHTS