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 伺服器上的影像。