Funzione WdsCliTransferImage (wdsclientapi.h)

Articolo
03/13/2024

Trasferisce un'immagine da un server WDS al client WDS.

Sintassi

HRESULT WDSCLIAPI WdsCliTransferImage(
  [in]           HANDLE             hImage,
  [in]           PWSTR              pwszLocalPath,
  [in]           DWORD              dwFlags,
  [in]           DWORD              dwReserved,
  [in, optional] PFN_WdsCliCallback pfnWdsCliCallback,
  [in, optional] PVOID              pvUserData,
  [out]          PHANDLE            phTransfer
);

Parametri

[in] hImage

Handle di immagine WDS che fa riferimento a un'immagine remota.

[in] pwszLocalPath

Puntatore a un valore stringa con terminazione Null contenente il percorso completo del percorso locale in cui archiviare il file di immagine 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 che riceverà i callback 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