WdsCliFindFirstImage 函数 (wdsclientapi.h)

启动存储在 WDS 服务器上的图像的枚举，并返回引用第一个图像的查找句柄。

语法

HRESULT WDSCLIAPI WdsCliFindFirstImage(
  [in]  HANDLE  hSession,
  [out] PHANDLE phFindHandle
);

[in] hSession

与 WDS 服务器的会话的句柄。这是 WdsCliCreateSession 函数返回的句柄。

[out] phFindHandle

指向接收查找句柄的 HANDLE 值的指针。如果函数成功，查找句柄将引用存储在 WDS 服务器上的第一个映像。如果该函数不成功，则此参数保持不变。使用 WdsCliFindNextImage 函数将查找句柄的引用推进到下一个图像。

注意只能通过使用 WDS 客户端 API 的图像信息函数从查找句柄获取有关映像的信息。

如果函数成功，则 返回S_OK。

会话必须经过身份验证才能使用此函数。若要对现有会话进行身份验证，请调用 WdsCliAuthorizeSession 函数。

此函数返回的 WDS 映像查找句柄可与 WdsCliFindNextImage 函数一起使用，以枚举存储在 WDS 服务器上的图像。