Funzione WsRequestSecurityToken (webservices.h)

Articolo
08/27/2023

Ottenere un token di sicurezza da un servizio token di sicurezza (STS) che funge da emittente di token in uno scenario federativo. Questa funzione viene usata sul lato client ed esegue i passaggi di negoziazione basati WS-Trust con il servizio token di sicurezza fino a quando il token di sicurezza non viene ottenuto o il processo di negoziazione non riesce.

Sintassi

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
);

Parametri

[in] channel

Canale in cui deve essere eseguita la negoziazione per ottenere il token di sicurezza.

Il canale fornito deve essere stato creato con il WS_SECURITY_DESCRIPTION appropriato per soddisfare i requisiti di sicurezza dell'emittente e quindi aperto al WS_ENDPOINT_ADDRESS dell'emittente. Il chiamante è anche responsabile della chiusura e della liberazione del canale dopo il completamento di questa funzione.

Pertanto, il canale deve essere nello stato WS_CHANNEL_STATE_OPEN quando questa funzione viene chiamata. Al termine di questa funzione, il canale sarà nello stato WS_CHANNEL_STATE_OPEN. Dopo un completamento non riuscito, sarà nello stato WS_CHANNEL_STATE_OPEN o nello stato WS_CHANNEL_STATE_FAULTED.

properties

Gruppo facoltativo di impostazioni da utilizzare nel processo di negoziazione con l'emittente.

[in] propertyCount

Numero di elementi nella matrice delle proprietà.

token

Token di sicurezza XML ottenuto. Questa impostazione viene impostata al completamento della chiamata di funzione e non modificata se si verifica un errore durante l'esecuzione della funzione.

Il token di sicurezza restituito può essere usato con WS_XML_TOKEN_MESSAGE_SECURITY_BINDING se deve essere presentato a un servizio. Il token deve essere liberato usando WsFreeSecurityToken quando non è più necessario.

[in, optional] asyncContext

Informazioni su come richiamare la funzione in modo asincrono o NULL se si richiama in modo sincrono.

[in, optional] error

Specifica dove archiviare informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
WS_S_ASYNC	L'operazione asincrona è ancora in sospeso.

Commenti

Windows 7 e Windows Server 2008 R2: WWSAPI supporta solo Ws-Trust e Ws-SecureConversation come definito da Lightweight Web Services Security Profile (LWSSP). Per informazioni dettagliate sull'implementazione di Microsoft, vedere la sezione Sintassi MESSAGE di LWSSP.

Requisiti


Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll

Condividi tramite