Método IMDSPObject::Read (mswmdm.h)

O método Read lê dados do objeto na posição atual. Essa operação só será válida se o objeto de armazenamento representar um arquivo.

Sintaxe

HRESULT Read(
  [out]     BYTE     *pData,
  [in, out] DWORD    *pdwSize,
  [in, out] BYTE [8] abMac
);

Parâmetros

[out] pData

Ponteiro para um buffer para receber os dados lidos do objeto. Esse parâmetro está incluído no código de autenticação de mensagem de saída e deve ser criptografado usando CSecureChannelServer::EncryptParam. Consulte Observações.

[in, out] pdwSize

Ponteiro para um DWORD que especifica o número de bytes de dados a serem lidos. Após o retorno, esse parâmetro contém a quantidade real de dados lidos. Esse parâmetro deve ser incluído no código de autenticação de mensagem de entrada.

[in, out] abMac

Matriz de oito bytes que contém o código de autenticação de mensagem para os dados de parâmetro desse método. (WMDM_MAC_LENGTH é definido como 8.)

Retornar valor

O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:

• Códigos de erro COM padrão
• Códigos de erro do Windows convertidos em valores HRESULT
• Códigos de erro de Gerenciador de Dispositivos do Windows Media

Para obter uma ampla lista de possíveis códigos de erro, consulte Códigos de erro.

Comentários

O MAC usado para criptografia deve incluir pData e pdwSize em chamadas para CSecureChannelServer::MACUpdate.

Esse método é opcional. Para obter mais informações, consulte Interfaces obrigatórias e opcionais.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	mswmdm.h
Biblioteca	Mssachlp.lib

Confira também

Criptografia e descriptografia

IMDSPObject Interface

IMDSPObject::Close

IMDSPObject::Open

IMDSPObject::Seek

IMDSPObject::Write