Функция WdsCliFindFirstImage (wdsclientapi.h)

Запускает перечисление изображений, хранящихся на сервере WDS, и возвращает дескриптор поиска, который ссылается на первый образ.

Синтаксис

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

Параметры

[in] hSession

Дескриптор сеанса с сервером WDS. Это был дескриптор, возвращенный функцией WdsCliCreateSession .

[out] phFindHandle

Указатель на значение HANDLE , которое получает дескриптор поиска. Если функция выполнена успешно, дескриптор поиска будет ссылаться на первый образ, хранящийся на сервере WDS. Если функция завершается неудачно, этот параметр не изменяется. Используйте функцию WdsCliFindNextImage , чтобы перейти к следующему изображению.

Примечание Сведения об образе можно получить только из дескриптора поиска с помощью функций сведений об образе клиентского API WDS.

 

Возвращаемое значение

Если функция выполняется успешно, возвращается S_OK.

Комментарии

Чтобы использовать эту функцию, сеанс должен пройти проверку подлинности. Для проверки подлинности существующего сеанса вызовите функцию WdsCliAuthorizeSession .

Дескриптор поиска образа WDS, возвращаемый этой функцией, можно использовать с функцией WdsCliFindNextImage для перечисления образов, хранящихся на сервере WDS.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	wdsclientapi.h
Библиотека	WdsClientAPI.lib
DLL	WdsClientAPI.dll

См. также раздел

Клиентские функции служб развертывания Windows