Método ISCPSecureQuery3::GetRightsOnClearChannel (mswmdm.h)

Artigo
03/13/2024

O método GetRightsOnClearChannel recupera informações de direitos para o conteúdo atual em um canal claro.

Sintaxe

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

Parâmetros

[in] pData

Ponteiro para o objeto de dados.

[in] dwSize

Número de bytes de dados no buffer pData .

[in] pbSPSessionKey

Ponteiro para uma matriz de bytes que contém a chave de sessão para proteger a comunicação com o provedor de serviços para o qual pStgGlobals aponta.

[in] dwSessionKeyLen

Comprimento da matriz de bytes para a qual pbSPSessionKey aponta.

[in] pStgGlobals

Ponteiro para uma interface IWMDMStorageGlobals no armazenamento raiz da mídia ou dispositivo para ou do qual o arquivo está sendo transferido.

[in] pProgressCallback

Ponteiro para uma interface IWMDMProgress3 .

[out] ppRights

Ponteiro para uma matriz de estruturas WMDMRIGHTS que contêm as informações de direitos desse objeto. A matriz é alocada por esse método e deve ser liberada usando CoTaskMemFree.

[out] pnRightsCount

Número de estruturas WMDMRIGHTS na matriz ppRights .

Retornar valor

Se o método for bem-sucedido, retornará S_OK. Se o método falhar, ele retornará um código de erro HRESULT .

Código de retorno	Descrição
WMDM_E_CALL_OUT_OF_SEQUENCE	Esse método foi chamado fora de sequência. ISCPSecureQuery::GetDataDemands e, em seguida, ISCPSecureQuery::ExamineData devem ser chamados, nessa ordem.
WMDM_E_MAC_CHECK_FAILED	O código de autenticação de mensagem não é válido.
WMDM_E_NORIGHTS	O chamador não tem os direitos necessários para executar a operação solicitada.
E_INVALIDARG	Um parâmetro é inválido ou é um ponteiro NULL .
E_FAIL	Ocorreu um erro não especificado.

Comentários

Esse método é idêntico a ISCPSecureQuery::GetRights , exceto que os parâmetros passados para esse método não são criptografados. Consequentemente, esse método é mais eficiente.