WdsCliGetImageHandleFromTransferHandle-Funktion (wdsclientapi.h)

Artikel
08/27/2023

Gibt ein Imagehandle aus einem abgeschlossenen Übertragungshandle zurück. Das Handle ist für die lokale Kopie des Images, das vom Server auf den Client übertragen wurde.

Syntax

HRESULT WDSCLIAPI WdsCliGetImageHandleFromTransferHandle(
        HANDLE  hTransfer,
  [out] PHANDLE phImageHandle
);

Parameter

hTransfer

Ein WDS-Übertragungshandle, das die Übertragung abgeschlossen hat. Dies kann der von den Funktionen WdsCliTransferImage oder WdsCliTransferFile zurückgegebene Handle sein.

[out] phImageHandle

Ein Zeiger auf eine Position, die ein Imagehandle enthält.

Rückgabewert

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

Hinweise

Wenn die Übertragung beim Aufruf dieser Funktion noch nicht abgeschlossen ist, wird ein Fehlercode zurückgegeben.

Verwenden Sie die WdsCliClose-Funktion , um das von dieser Funktion zurückgegebene Bildhandle zu schließen.

Anforderungen


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