функция обратного вызова WS_GET_CERT_CALLBACK (webservices.h)

Статья
08/27/2023

Предоставляет сертификат для среды выполнения безопасности. Этот обратный вызов указывается как часть WS_CUSTOM_CERT_CREDENTIAL, которая, в свою очередь, может быть указана как часть привязки безопасности, требующей учетных данных сертификата. Среда выполнения вызовет этот обратный вызов при открытии канала (на стороне клиента) или прослушивателя (на стороне сервера).

Владение сертификатом. Если этот обратный вызов возвращает успешное выполнение HRESULT, вызывающий объект (а именно среда выполнения безопасности) возьмет на себя владение возвращенным сертификатом и освободит его, когда содержащий канал больше не нужен. Если этот обратный вызов возвращает ошибку HRESULT, вызывающий объект НЕ будет овладеть или даже не будет рассматривать значение, возвращаемое в параметре out "cert".

Синтаксис

WS_GET_CERT_CALLBACK WsGetCertCallback;

HRESULT WsGetCertCallback(
  [in]           void *getCertCallbackState,
  [in, optional] const WS_ENDPOINT_ADDRESS *targetAddress,
  [in, optional] const WS_STRING *viaUri,
                 const _CERT_CONTEXT **cert,
  [in, optional] WS_ERROR *error
)
{...}

Параметры

[in] getCertCallbackState

Состояние, указанное вместе с этим обратным вызовом в учетных данных сертификата.

[in, optional] targetAddress

Целевой адрес, которому должен быть предоставлен этот сертификат, если эти учетные данные сертификата указаны для клиента.

[in, optional] viaUri

Адрес через , которому должен быть представлен этот сертификат.

cert

Расположение для возврата сертификата.

[in, optional] error

Указывает, где должны храниться дополнительные сведения об ошибке в случае сбоя функции.

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

Эта функция обратного вызова не возвращает значение.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	webservices.h

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