Método IWMDMOperation::End (mswmdm.h)
O método End indica que uma operação de leitura ou gravação foi concluída, com êxito ou não, e retorna um código de conclusão.
Sintaxe
HRESULT End(
[in] HRESULT *phCompletionCode,
[in] IUnknown *pNewObject
);
Parâmetros
[in] phCompletionCode
Código de conclusão para a operação.
[in] pNewObject
Ao enviar para um dispositivo, um ponteiro para um novo objeto IWMDMStorage que representa o novo objeto que foi enviado para o dispositivo. Ao ler de um dispositivo, um ponteiro para o objeto IWMDMStorage que foi lido do dispositivo.
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
Comentários
O método End é chamado se a transferência foi ou não bem-sucedida e é o último método IWMDMOperation chamado. Esse método pode ser usado para sinalizar o aplicativo para fechar todos os identificadores de arquivo e outros objetos exigidos pela operação de leitura ou gravação.
Exemplos
O código C++ a seguir fecha um identificador de arquivo global após uma ação de leitura ou gravação e gera uma mensagem.
HRESULT End(HRESULT* phCompletionCode, IUnknown* pNewObject)
{
// TODO: Display the message: "IWMDMOperation event--End."
// Close the file handle now that we're done with it.
if (m_File != INVALID_HANDLE_VALUE)
if (!CloseHandle(m_File))
// TODO: Display the message: "Couldn't close the file."
// Reset global status flag.
m_OperationStatus = OPERATION_UNINITIALIZED;
return S_OK;
}
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Windows |
Cabeçalho | mswmdm.h |
Biblioteca | Mssachlp.lib |