Metodo ISCPSecureQuery::GetRights (mswmdm.h)

Articolo
02/29/2024

Il metodo GetRights recupera le informazioni sui diritti per il contenuto corrente. I diritti sono specifici del file.

Sintassi

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
);

Parametri

[in] pData

Puntatore ai dati richiesti da GetDataDemands. Questo parametro deve essere incluso nel codice di autenticazione del messaggio di input e deve essere crittografato.

[in] dwSize

Numero di byte di dati nel buffer pData . Questo parametro deve essere incluso nel codice di autenticazione del messaggio di input.

[in] pbSPSessionKey

Puntatore a una matrice di byte contenente la chiave di sessione per proteggere la comunicazione con il provider di servizi a cui pStgGlobals punta. Questo parametro deve essere incluso nel codice di autenticazione del messaggio di input e deve essere crittografato.

[in] dwSessionKeyLen

Lunghezza della matrice di byte a cui pbSPSessionKey punta. Questo parametro deve essere incluso nel codice di autenticazione del messaggio di input.

[in] pStgGlobals

Puntatore a un'interfaccia IWMDMStorageGlobals nell'archiviazione radice del supporto o del dispositivo a o da cui viene trasferito il file.

[out] ppRights

Puntatore a una matrice di strutture WMDMRIGHTS contenenti le informazioni sui diritti per questo oggetto. La matrice viene allocata da questo metodo e deve essere liberata usando CoTaskMemFree. Questo parametro è incluso nel codice di autenticazione del messaggio di output.

[out] pnRightsCount

Numero di strutture WMDMRIGHTS nella matrice ppRights . Questo parametro è incluso nel codice di autenticazione del messaggio di output.

[in, out] abMac

Matrice di otto byte contenente il codice di autenticazione dei messaggi per i dati dei parametri di questo metodo. (WMDM_MAC_LENGTH è definito come 8.)

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, restituisce un codice di errore HRESULT .

Codice restituito	Descrizione
WMDM_E_CALL_OUT_OF_SEQUENCE	Questo metodo è stato chiamato fuori dalla sequenza. GetDataDemands e quindi ExamineData deve essere chiamato prima, in tale ordine.
WMDM_E_MAC_CHECK_FAILED	Il codice di autenticazione del messaggio non è valido.
WMDM_E_NORIGHTS	Il chiamante non dispone dei diritti necessari per eseguire l'operazione richiesta.
E_INVALIDARG	Un parametro non è valido o è un puntatore NULL .
E_FAIL	Si è verificato un errore non specificato.

Commenti

Questo metodo non deve essere chiamato finché GetDataDemands e quindi ExamineData è stato chiamato, in tale ordine.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	mswmdm.h
Libreria	Mssachlp.lib

Vedi anche

Interfaccia ISCPSecureQuery

Interfaccia IWMDMStorageGlobals

WMDMRIGHTS

Condividi tramite