Funzione WdsCliTransferFile (wdsclientapi.h)

Articolo
03/13/2024

Trasferisce un file da un server WDS al client WDS usando un protocollo di trasferimento multicast.

Sintassi

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
);

Parametri

[in] pwszServer

Puntatore a un valore stringa con terminazione Null contenente il nome del server WDS.

[in] pwszNamespace

Puntatore a un valore stringa con terminazione Null contenente il nome dello spazio dei nomi multicast per l'immagine.

[in] pwszRemoteFilePath

Puntatore a un valore stringa con terminazione Null che contiene il percorso completo per il percorso remoto da cui copiare il file da trasferire.

[in] pwszLocalFilePath

Puntatore a un valore stringa con terminazione Null contenente il percorso completo del percorso locale in cui archiviare il file da trasferire.

[in] dwFlags

Opzioni associate al trasferimento di file.

Valore	Significato
WDS_CLI_TRANSFER_ASYNCHRONOUS	Questo flag specifica un trasferimento asincrono.

[in] dwReserved

Questo parametro è riservato.

[in, optional] pfnWdsCliCallback

Puntatore a una funzione di callback facoltativa per questo trasferimento.

[in, optional] pvUserData

Puntatore alle informazioni utente facoltative che possono essere passate alla funzione di callback.

[out] phTransfer

Puntatore a un handle di trasferimento che può essere utilizzato con le funzioni WdsCliWaitForTransfer o WdsCliCancelTransfer per attendere il completamento del trasferimento o per annullare il trasferimento.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene S_OK.

Commenti

Chiamare la funzione WdsCliClose per chiudere l'handle restituito da questa funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista con SP1 [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wdsclientapi.h
Libreria	WdsClientAPI.lib
DLL	WdsClientAPI.dll

Condividi tramite