Freigeben über


WdsCliGetImagePath-Funktion (wdsclientapi.h)

Gibt den Pfad zur Datei zurück, die das aktuelle Image enthält.

Syntax

HRESULT WDSCLIAPI WdsCliGetImagePath(
  [in]  HANDLE hIfh,
  [out] PWSTR  *ppwszValue
);

Parameter

[in] hIfh

Ein Suchhandle, das von der WdsCliFindFirstImage-Funktion zurückgegeben wird. Das Bild, auf das vom Suchhandle verwiesen wird, kann mithilfe der WdsCliFindNextImage-Funktion erweitert werden.

[out] ppwszValue

Ein Zeiger auf einen Zeiger auf eine NULL-Zeichenfolge, die den relativen Pfad der Bilddatei für das aktuelle Bild enthält.

Rückgabewert

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

Hinweise

Dieser Wert ist gültig, bis die WdsCliFindNextImage - oder WdsCliClose-Funktion verwendet wird, um das aktuelle Handle zu ändern oder zu schließen.

Um den vollständigen Pfad zur Imagedatei abzurufen, präfixieren Sie den in ppWszValue zurückgegebenen relativen Pfad mit "\\Server\RemInst".

Anforderungen

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

Weitere Informationen

WdsCliClose

WdsCliFindFirstImage

WdsCliFindNextImage

Clientfunktionen der Windows-Bereitstellungsdienste