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

  • Artículo

Obtiene la ruta de acceso completa del archivo temporal que contiene el contenido de la descarga.

Sintaxis

HRESULT GetTemporaryName(
  [out] LPWSTR *pFilename
);

Parámetros

[out] pFilename

Cadena terminada en NULL que contiene la ruta de acceso completa del archivo temporal. Llame a la función CoTaskMemFree para liberar ppFileName cuando haya terminado.

Valor devuelto

El método devuelve los siguientes valores devueltos.

Código devuelto Descripción
S_OK
 Correcto

Comentarios

Las aplicaciones pueden usar este método para obtener acceso a los datos antes de que se complete el trabajo. Abra el archivo para el acceso de escritura compartido (FILE_SHARE_WRITE). Para determinar cuántos bytes se han transferido y están disponibles para su lectura, llame al método IBackgroundCopyFile::GetProgress . Tenga en cuenta que la información de progreso se volverá a establecer en cero si cambia la marca de tiempo de la dirección URL.

No abra el archivo para leer hasta que BITS comience a transferir el archivo; de lo contrario, el trabajo entrará en el estado de error transitorio.

El archivo temporal está disponible hasta que la aplicación llame al método IBackgroundCopyJob::Complete o IBackgroundCopyJob::Cancel o a la directiva de grupo JobInactivityTimeout. Debe liberar el identificador en el archivo temporal antes de llamar al método Complete o Cancel .

La ACL del archivo temporal es la misma que la del archivo final cuando se llama a Complete (la ACL se hereda de la carpeta).

Para determinar si BITS ha terminado de transferir el archivo, puede hacer lo siguiente:

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado bits3_0.h (incluya Bits.h)
Library Bits.lib

Consulte también

IBackgroundCopyCallback2::FileTransferred

IBackgroundCopyFile3