WdsCliTransferImage-Funktion (wdsclientapi.h)

Artikel
03/06/2024

Überträgt ein Image von einem WDS-Server auf den WDS-Client.

Syntax

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

Parameter

[in] hImage

Ein WDS-Imagehandle, das auf ein Remoteimage verweist.

[in] pwszLocalPath

Ein Zeiger auf einen null-beendeten Zeichenfolgenwert, der den vollständigen Pfad zum lokalen Speicherort zum Speichern der übertragenen Imagedatei enthält.

[in] dwFlags

Optionen, die der Dateiübertragung zugeordnet sind.

Wert	Bedeutung
WDS_CLI_TRANSFER_ASYNCHRONOUS	Dieses Flag gibt eine asynchrone Übertragung an.

[in] dwReserved

Dieser Parameter ist reserviert.

[in, optional] pfnWdsCliCallback

Ein Zeiger auf eine optionale Rückruffunktion, die Rückrufe für diese Übertragung empfängt.

[in, optional] pvUserData

Ein Zeiger auf optionale Benutzerinformationen, die an die Rückruffunktion übergeben werden können.

[out] phTransfer

Ein Zeiger auf ein Übertragungshandle, das mit den Funktionen WdsCliWaitForTransfer oder WdsCliCancelTransfer verwendet werden kann, um auf den Abschluss der Übertragung zu warten oder die Übertragung abzubrechen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird die Rückgabe S_OK.

Hinweise

Rufen Sie die WdsCliClose-Funktion auf, um das von dieser Funktion zurückgegebene Handle zu schließen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wdsclientapi.h
Bibliothek	WdsClientAPI.lib
DLL	WdsClientAPI.dll

Freigeben über