Método IBackgroundCopyFile3::GetTemporaryName (bits3_0.h)

Obtém o caminho completo do arquivo temporário que contém o conteúdo do download.

Sintaxe

HRESULT GetTemporaryName(
  [out] LPWSTR *pFilename
);

Parâmetros

[out] pFilename

Cadeia de caracteres terminada em nulo que contém o caminho completo do arquivo temporário. Chame a função CoTaskMemFree para liberar ppFileName quando terminar.

Retornar valor

O método retorna os seguintes valores retornados.

Comentários

Os aplicativos podem usar esse método para obter acesso aos dados antes que o trabalho seja concluído. Abra o arquivo para acesso de gravação compartilhado (FILE_SHARE_WRITE). Para determinar quantos bytes foram transferidos e estão disponíveis para leitura, chame o método IBackgroundCopyFile::GetProgress . Observe que as informações de progresso serão definidas como zero se o carimbo de data/hora da URL for alterado.

Não abra o arquivo para leitura até que o BITS comece a transferir o arquivo; caso contrário, o trabalho entrará no estado de erro transitório.

O arquivo temporário está disponível até que o aplicativo chame o método IBackgroundCopyJob::Complete ou IBackgroundCopyJob::Cancel ou a política de grupo JobInactivityTimeout expire. Você deve liberar o identificador para o arquivo temporário antes de chamar o método Complete ou Cancel .

A ACL para o arquivo temporário é a mesma do arquivo final quando Complete é chamado (a ACL é herdada da pasta).

Para determinar se o BITS terminou de transferir o arquivo, você pode:

• Chame o método IBackgroundCopyFile::GetProgress e compare BytesTransferred com BytesTotal.
• Implemente o retorno de chamada IBackgroundCopyCallback2::FileTransferred .

Requisitos

Confira também

IBackgroundCopyCallback2::FileTransferred

IBackgroundCopyFile3