WdsCliFindFirstImage

WdsCliFindFirstImage function

Starts the enumeration of images stored on a WDS server and returns a find handle that references the first image.

Syntax


HRESULT WDSCLIAPI WdsCliFindFirstImage(
  _In_  HANDLE  hSession,
  _Out_ PHANDLE phFindHandle
);

Parameters

hSession [in]

A handle to a session with a WDS server. This was a handle returned by the WdsCliCreateSession function.

phFindHandle [out]

Pointer to a HANDLE value that receives the find handle. If the function succeeds, the find handle will reference the first image stored on the WDS server. If the function is unsuccessful, this parameter is unchanged. Use the WdsCliFindNextImage function to advance the reference of the find handle to the next image.

Note  Information about the image can only be obtained from the find handle by using the image information functions of the WDS client API.
 

Return value

If the function succeeds, the return is S_OK.

Remarks

The session must be authenticated to use this function. To authenticate an existing session, call the WdsCliAuthorizeSession function.

The WDS image find handle returned by this function can be used with the WdsCliFindNextImage function to enumerate the images stored on the WDS server.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

WdsClientAPI.h

Library

WdsClientAPI.lib

DLL

WdsClientAPI.dll

See also

Windows Deployment Services Client Functions

 

 

Community Additions

ADD
Show:
© 2016 Microsoft