Функция 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
Указывает, где должны храниться дополнительные сведения об ошибке в случае сбоя функции.
Возвращаемое значение
Эта функция может возвращать одно из этих значений.
Код возврата | Описание |
---|---|
|
Асинхронная операция по-прежнему находится в состоянии ожидания. |
Комментарии
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 |