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


Функция WsRequestSecurityToken (webservices.h)

Получите маркер безопасности из службы маркеров безопасности (STS), которая выступает в качестве издателя маркеров в сценарии федерации. Эта функция используется на стороне клиента и выполняет WS-Trust этапы согласования с sts до получения маркера безопасности или завершения процесса согласования.

Синтаксис

HRESULT WsRequestSecurityToken(
  [in]           WS_CHANNEL                               *channel,
                 const WS_REQUEST_SECURITY_TOKEN_PROPERTY *properties,
  [in]           ULONG                                    propertyCount,
                 WS_SECURITY_TOKEN                        **token,
  [in, optional] const WS_ASYNC_CONTEXT                   *asyncContext,
  [in, optional] WS_ERROR                                 *error
);

Параметры

[in] channel

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

Предоставленный канал должен быть создан с соответствующим WS_SECURITY_DESCRIPTION в соответствии с требованиями безопасности издателя, а затем открыт для WS_ENDPOINT_ADDRESS издателя. Вызывающий объект также отвечает за закрытие и освобождение канала после завершения этой функции.

Таким образом, канал должен находиться в состоянии WS_CHANNEL_STATE_OPEN при вызове этой функции. После успешного выполнения этой функции канал будет находиться в состоянии WS_CHANNEL_STATE_OPEN. После неудачного завершения он будет находиться в состоянии WS_CHANNEL_STATE_OPEN или WS_CHANNEL_STATE_FAULTED.

properties

Необязательная группа параметров для использования в процессе согласования с издателем.

[in] propertyCount

Количество элементов в массиве свойств.

token

Полученный МАРКЕР безопасности XML. Этот параметр устанавливается после успешного завершения вызова функции и не меняемся, если во время выполнения функции возникает сбой.

Возвращаемый маркер безопасности можно использовать с WS_XML_TOKEN_MESSAGE_SECURITY_BINDING , если он должен быть представлен службе. Маркер должен быть освобожден с помощью WsFreeSecurityToken , если он больше не нужен.

[in, optional] asyncContext

Сведения об асинхронном вызове функции или значении NULL при синхронном вызове.

[in, optional] error

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

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

Эта функция может возвращать одно из этих значений.

Код возврата Описание
WS_S_ASYNC
Асинхронная операция по-прежнему находится в состоянии ожидания.

Комментарии

Windows 7 и Windows Server 2008 R2: WWSAPI поддерживает только Ws-Trust и Ws-SecureConversation, как определено в профиле безопасности упрощенных веб-служб (LWSSP). Дополнительные сведения о реализации корпорации Майкрософт см. в разделе Синтаксис СООБЩЕНИЯ статьи LWSSP.

Требования

   
Минимальная версия клиента Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header webservices.h
Библиотека WebServices.lib
DLL WebServices.dll