Funzione WsCreateXmlSecurityToken (webservices.h)

Articolo
03/15/2023

Crea un token di sicurezza dal modulo XML specificato.

Sintassi

HRESULT WsCreateXmlSecurityToken(
  [in]           WS_XML_BUFFER                        *tokenXml,
  [in, optional] WS_SECURITY_KEY_HANDLE               *tokenKey,
                 const WS_XML_SECURITY_TOKEN_PROPERTY *properties,
  [in]           ULONG                                propertyCount,
                 WS_SECURITY_TOKEN                    **token,
  [in, optional] WS_ERROR                             *error
);

Parametri

[in] tokenXml

Puntatore a una struttura WS_XML_BUFFER contenente il token di sicurezza nel formato XML. Il buffer a cui si fa riferimento deve avere esattamente un elemento XML di primo livello.

[in, optional] tokenKey

Puntatore a una struttura SECURITY_KEY_HANDLE che può o non contenere una chiave di prova crittografica. Se presente la chiave può essere usata per associare questo token di sicurezza a un messaggio. Se il valore del parametro tokenKey non è NULL, si presuppone che il token disponga di una chiave di verifica del possesso. Se il valore è NULL, si presuppone che la struttura sia un "token di connessione" come definito di seguito.

Un token di connessione denominato anche token basic o senza chiave viene serializzato in un messaggio per illustrare il possesso del token e per indicare l'intenzione di applicare le attestazioni dal token a tale messaggio.
Un token di prova di possesso denominato anche token poP o crittografico ha una chiave crittografica associata che deve essere usata per "firmare" un messaggio per dimostrare il possesso del token e per indicare l'intenzione di applicare le attestazioni dal token a tale messaggio. Un esempio è un certificato X.509: il messaggio deve essere firmato con la chiave privata del certificato per consentire a un'entità ricevente di accettare il messaggio come porta le attestazioni presenti nel certificato.

properties

Matrice di strutture WS_XML_SECURITY_TOKEN_PROPERTY contenenti proprietà facoltative per il token di sicurezza XML.

Il valore di questo parametro può essere NULL, in tal caso, il parametro propertyCount deve essere 0 (zero).

[in] propertyCount

Numero di proprietà nella matrice delle proprietà .

token

In caso di esito positivo, un puntatore che riceve l'indirizzo della struttura WS_SECURITY_TOKEN che rappresenta il token di sicurezza XML creato.

Quando questa struttura non è più necessaria, è necessario liberarla chiamando WsFreeSecurityToken.

Il token di sicurezza restituito può essere usato con WS_XML_TOKEN_MESSAGE_SECURITY_BINDING se deve essere

presentato a un servizio.

[in, optional] error

Puntatore a una struttura WS_ERROR che riceve informazioni di errore aggiuntive se la funzione ha esito negativo.

Valore restituito

Se la funzione ha esito positivo, restituisce NO_ERROR; in caso contrario, restituisce un codice di errore HRESULT.

Codice restituito	Descrizione
E_INVALIDARG	Uno o più argomenti non sono validi.
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.
Altri errori	Questa funzione può restituire altri errori non elencati sopra.

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