Поделиться через

Функция 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