Compartilhar via


Método GetObjectDataOnClearChannel

O método GetObjectDataOnClearChannel transfere um bloco de dados de objeto em um canal claro de volta para o Windows Media Gerenciador de Dispositivos.

Esse método é idêntico a ISCPSecureExchange::ObjectData , exceto que os dados retornados por esse método não são criptografados. Consequentemente, esse método é mais eficiente.

Sintaxe

HRESULT GetObjectDataOnClearChannel(
   IMDSPDevice *pDevice,
   BYTE        *pData,
   DWORD       *pdwSize
);

Parâmetros

pDevice

Ponteiro para o objeto do dispositivo.

pData

Ponteiro para um buffer para receber dados.

Pdwsize

Ponteiro para um DWORD que contém o tamanho da transferência.

Valor retornado

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_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.
S_FALSE
O método falhou. Encerre a interação com o provedor de conteúdo.
E_INVALIDARG
Um parâmetro é um ponteiro nulo ou inválido.
E_FAIL
Ocorreu um erro não especificado.

Comentários

Para transferir dados, o Windows Media Gerenciador de Dispositivos chama o método TransferContainerDataOnClearChannel para obter os dados do contêiner. GetObjectDataOnClearChannel é chamado para transferir blocos de dados de objeto do provedor de conteúdo para o Windows Media Gerenciador de Dispositivos. Se S_OK for retornado com pdwSize definido como zero, o Windows Media Gerenciador de Dispositivos não solicitará mais dados.

Esse método é idêntico a ISCPSecureExchange::ObjectData , exceto que os dados retornados por esse método não são criptografados. Consequentemente, esse método é mais eficiente.

Requisitos

Requisito Valor
parâmetro
WMSCP.idl
Biblioteca
Mssachlp.lib

Confira também

ISCPSecureExchange::ObjectData

ISCPSecureExchange3 Interface