Metodo ISCPSecureQuery3::GetRightsOnClearChannel (mswmdm.h)

Articolo
02/29/2024

Il metodo GetRightsOnClearChannel recupera le informazioni sui diritti per la parte corrente di contenuto in un canale non crittografato.

Sintassi

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

Parametri

[in] pData

Puntatore all'oggetto dati.

[in] dwSize

Numero di byte di dati nel buffer pData .

[in] pbSPSessionKey

Puntatore a una matrice di byte contenente la chiave di sessione per proteggere la comunicazione con il provider di servizi a cui punta pStgGlobals .

[in] dwSessionKeyLen

Lunghezza della matrice di byte a cui punta pbSPSessionKey .

[in] pStgGlobals

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

[in] pProgressCallback

Puntatore a un'interfaccia IWMDMProgress3 .

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

[out] pnRightsCount

Numero di strutture WMDMRIGHTS nella matrice ppRights .

Valore restituito

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

Codice restituito	Descrizione
WMDM_E_CALL_OUT_OF_SEQUENCE	Questo metodo è stato chiamato fuori sequenza. ISCPSecureQuery::GetDataDemands e quindi è necessario chiamare ISCPSecureQuery::ExamineData , 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 è identico a ISCPSecureQuery::GetRights , ad eccezione del fatto che i parametri passati a questo metodo non sono crittografati. Di conseguenza, questo metodo è più efficiente.