ISCPSecureQuery::GetRights-Methode (mswmdm.h)

Artikel
08/25/2023

Die GetRights-Methode ruft Rechteinformationen für den aktuellen Inhalt ab. Rechte sind dateispezifisch.

Syntax

HRESULT GetRights(
  [in]      BYTE                *pData,
  [in]      DWORD               dwSize,
  [in]      BYTE                *pbSPSessionKey,
  [in]      DWORD               dwSessionKeyLen,
  [in]      IMDSPStorageGlobals *pStgGlobals,
  [out]     PWMDMRIGHTS         *ppRights,
  [out]     UINT                *pnRightsCount,
  [in, out] BYTE [8]            abMac
);

Parameter

[in] pData

Zeiger auf daten, die von GetDataDemands angefordert werden. Dieser Parameter muss im Authentifizierungscode der Eingabenachricht enthalten sein und verschlüsselt sein.

[in] dwSize

Anzahl der Bytes der Daten im pData-Puffer . Dieser Parameter muss im Authentifizierungscode der Eingabenachricht enthalten sein.

[in] pbSPSessionKey

Zeiger auf ein Bytearray, das den Sitzungsschlüssel zum Sichern der Kommunikation mit dem Dienstanbieter enthält, auf den pStgGlobals verweist. Dieser Parameter muss im Authentifizierungscode der Eingabenachricht enthalten sein und verschlüsselt sein.

[in] dwSessionKeyLen

Länge des Bytearrays, auf das pbSPSessionKey verweist. Dieser Parameter muss im Authentifizierungscode der Eingabenachricht enthalten sein.

[in] pStgGlobals

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

[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. Dieser Parameter ist im Authentifizierungscode der Ausgabenachricht enthalten.

[out] pnRightsCount

Anzahl der WMDMRIGHTS-Strukturen im ppRights-Array . 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_CALL_OUT_OF_SEQUENCE	Diese Methode wurde außerhalb der Reihenfolge aufgerufen. GetDataDemands und dann ExamineData müssen zuerst 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 darf erst aufgerufen werden, wenn GetDataDemands und anschließend ExamineData in dieser Reihenfolge aufgerufen wurden.

Anforderungen

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

Weitere Informationen

ISCPSecureQuery-Schnittstelle

IWMDMStorageGlobals-Schnittstelle

WMDMRIGHTS

Freigeben über