WdsCliTransferFile-Funktion (wdsclientapi.h)

Artikel
03/03/2024

Überträgt eine Datei von einem WDS-Server mithilfe eines Multicastübertragungsprotokolls an den WDS-Client.

Syntax

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

Parameter

[in] pwszServer

Ein Zeiger auf einen NULL-endend-Zeichenfolgenwert, der den WDS-Servernamen enthält.

[in] pwszNamespace

Ein Zeiger auf einen Null-endend-Zeichenfolgenwert, der den Multicastnamespacenamen für das Image enthält.

[in] pwszRemoteFilePath

Ein Zeiger auf einen Null-endend-Zeichenfolgenwert, der den vollständigen Pfad für den Remotespeicherort enthält, von dem die übertragene Datei kopiert werden soll.

[in] pwszLocalFilePath

Ein Zeiger auf einen NULL-endend-Zeichenfolgenwert, der den vollständigen Pfad zum lokalen Speicherort zum Speichern der übertragenen Datei enthält.

[in] dwFlags

Der Dateiübertragung zugeordnete Optionen.

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 für diese Übertragung.

[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