Метод IUpdateEndpointProvider::GetServiceEndpoint

Статья
12/06/2023

Запрашивает конечную точку, используемую для подключения к службе.

Синтаксис

HRESULT GetServiceEndpoint(
  [in]  GUID                        ServiceId,
  [in]  UpdateEndpointType          endpointType,
  [in]  UpdateEndpointProxySettings proxySettings,
  [in]  HANDLE_PTR                  hUserToken,
  [in]  BOOL                        fRefreshOnline,
  [out] BSTR                        *pbstrEndpointLoc
);

Параметры

ServiceId [in]

Определяет службу, которая будет обновлена.

endpointType [in]

Определяет тип конечной точки, реализованной службой.

Перечисление UpdateEndpointType определяет следующие константы.

uetClientServer

Конечная точка клиентского сервера, используемая для подключения к службе обновления.

uetReporting

Конечная точка отчетов, которая используется, когда клиент сообщает результаты сканирования, скачивания и установки обратно в службу обновления.

uetWuaSelfUpdate

Конечная точка самостоятельного обновления, используемая при обращении клиентского компьютера к службе обновления, чтобы узнать, существует ли новая версия клиентского программного обеспечения агента Обновл. Windows.

uetRegulation

Конечная точка регламента, используемая, когда клиентский компьютер обращается к службе регулирования для выполнения определенных обновлений, применимых к целевому компьютеру.

uetSimpleTargeting

Конечная точка простого назначения, используемая только с частными службами (серверы WSUS в корпоративных средах).

proxy Параметры [in]

Определяет параметры, используемые при подключении к прокси-серверу.

hUserToken [in]

Содержит объект дескриптора маркера, представляющий пользователя. Поставщик конечных точек использует этот маркер для определения параметров и учетных данных прокси-сервера.

fRefreshOnline [in]

Указывает погоду WUA запрашивает новый маркер. Значение True указывает, что запрашивается новый маркер. False указывает, что запрашивается новый или кэшированный маркер. Дополнительные сведения см. в примечаниях.

pbstrEndpointLoc [out]

Укажите URL-адрес, используемый для взаимодействия со службой. Например, для конечной точки клиентского сервера это будет URL-адрес службы клиентского сервера. Дополнительные сведения см. в примечаниях.

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

Возвращает S_OK в случае успешного выполнения. В противном случае возвращает код ошибки COM или Windows.

Замечания

WUA обычно задает для параметра fRefreshOnline значение false при первом вызове этого метода, а если при повторном вызове метода возникает ошибка подключения, то если при вызове метода возникает ошибка подключения, этот параметр имеет значение true. Однако реализация этого метода может запрашивать новый токен из службы маркеров безопасности (STS) или предоставлять кэшированный маркер в любое время.

Если конечная точка не требует проверки подлинности, вызывающий объект может подключиться к службе, используя только URL-адрес, указанный параметром pbstrEndpointLoc .

Если конечная точка нуждается в проверке подлинности, вызывающий объект может использовать URL-адрес, указанный параметром pbstrEndpointLoc , и данные, предоставляемые другими параметрами.

Requirements

Требование	Значение
Минимальная версия клиента	Windows XP, Windows 2000 Профессиональный с пакетом обновления 3 (SP3) [только классические приложения]
Минимальная версия сервера	Windows Server 2003, Windows 2000 Server с пакетом обновления 3 (SP3) [классические приложения только]
Верхний колонтитул	UpdateEndpointAuth.h
IDL	UpdateEndpointAuth.idl
Библиотека	UpdateEndpointAuth.lib
DLL-библиотеки	UpdateEndpointAuth.dll

См. также

IUpdateEndpointProvider

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