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

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

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

Confira também

Manipulando transferências de arquivos manualmente

IWMDMOperation Interface