Función WdsCliTransferFile (wdsclientapi.h)

Transfiere un archivo de un servidor WDS al cliente WDS mediante un protocolo de transferencia de multidifusión.

Sintaxis

HRESULT WDSCLIAPI WdsCliTransferFile(
  [in]           PCWSTR             pwszServer,
  [in]           PCWSTR             pwszNamespace,
  [in]           PCWSTR             pwszRemoteFilePath,
  [in]           PCWSTR             pwszLocalFilePath,
  [in]           DWORD              dwFlags,
  [in]           DWORD              dwReserved,
  [in, optional] PFN_WdsCliCallback pfnWdsCliCallback,
  [in, optional] PVOID              pvUserData,
  [out]          PHANDLE            phTransfer
);

Parámetros

[in] pwszServer

Puntero a un valor de cadena terminada en null que contiene el nombre del servidor WDS.

[in] pwszNamespace

Puntero a un valor de cadena terminada en null que contiene el nombre del espacio de nombres de multidifusión para la imagen.

[in] pwszRemoteFilePath

Puntero a un valor de cadena terminada en null que contiene la ruta de acceso completa de la ubicación remota desde la que se va a copiar el archivo que se va a transferir.

[in] pwszLocalFilePath

Puntero a un valor de cadena terminada en null que contiene la ruta de acceso completa a la ubicación local para almacenar el archivo que se va a transferir.

[in] dwFlags

Opciones asociadas a la transferencia de archivos.

Valor	Significado
WDS_CLI_TRANSFER_ASYNCHRONOUS	Esta marca especifica una transferencia asincrónica.

[in] dwReserved

Este parámetro está reservado.

[in, optional] pfnWdsCliCallback

Puntero a una función de devolución de llamada opcional para esta transferencia.

[in, optional] pvUserData

Puntero a la información de usuario opcional que se puede pasar a la función de devolución de llamada.

[out] phTransfer

Puntero a un identificador de transferencia que se puede usar con las funciones WdsCliWaitForTransfer o WdsCliCancelTransfer para esperar a que la transferencia se complete o cancele la transferencia.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es S_OK.

Comentarios

Llame a la función WdsCliClose para cerrar el identificador devuelto por esta función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista con SP1 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wdsclientapi.h
Library	WdsClientAPI.lib
Archivo DLL	WdsClientAPI.dll