WdsCliFindNextImage function (wdsclientapi.h)

Advances the reference of a find handle to the next image stored on a WDS server.

Syntax

HRESULT WDSCLIAPI WdsCliFindNextImage(
  [in] HANDLE Handle
);

Parameters

[in] Handle

The find handle returned by the WdsCliFindFirstImage function. If the WdsCliFindNextImage function is successful, the reference of the find handle is advanced to the next image stored on the WDS server.

Return value

If the function succeeds, the return is S_OK.

If the function succeeds, and the end of the enumeration has been reached, the return is HRESULT_FROM_WIN32(ERROR_NO_MORE_FILES).

Remarks

To enumerate all the images on a WDS Server, first get the WDS image find handle by calling the WdsCliFindFirstImage function, and then make repeated calls to WdsCliFindNextImage until the function returns HRESULT_FROM_WIN32(ERROR_NO_MORE_FILES).

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header wdsclientapi.h
Library WdsClientAPI.lib
DLL WdsClientAPI.dll

See also

Windows Deployment Services Client Functions