# 22. Virtuoso Functions Guide - uddi_discard_authToken

Chapter Contents | Prev | Next
Keyword Search:
www.openlinksw.com
docs.openlinksw.com
Book Home
Contents
Preface
Virtuoso Functions Guide
Administration
Aggregate Functions
Array Manipulation
BPEL APIs
Backup
Compression
Cursor
Date & Time Manipulation
Debug
Dictionary Manipulation
Encoding & Decoding
File Manipulation
Free Text
Hashing / Cryptographic
LDAP
Locale
Mail
Miscellaneous
Number
Remote SQL Data Source
Replication
SOAP
SQL
String
Transaction
Type Mapping
UDDI
uddi_delete_binding
uddi_delete_business
uddi_delete_service
uddi_delete_tmodel
uddi_discard_authtok...
uddi_find_binding
uddi_find_business
uddi_find_service
uddi_find_tmodel
uddi_get_authtoken
uddi_get_bindingdeta...
uddi_get_businessdet...
uddi_get_businessdet...
uddi_get_registeredi...
uddi_get_servicedeta...
uddi_get_tmodeldetai...
uddi_save_binding
uddi_save_business
uddi_save_service
uddi_save_tmodel
User Defined Types & The CLR
Virtuoso Java PL API
Virtuoso Server Extension Interface (VSEI)
Web Server & Internet
XML
XPATH & XQUERY
Functions Index

## uddi_discard_authToken

Inform a UDDI server that the authentication token can be discarded.
Syntax

    <uddi_discard_authToken
      generic="1.0"
      xmlns="urn:uddi-org:api" >
    	<authInfo/>
    </uddi_discard_authToken>

Description

The uddi_discard_authToken message is used to tell a UDDI-enabled server that the authentication token can be discarded. Subsequent calls that use the same authToken may be rejected. This message is optional for UDDI-enabled servers that do not manage session state or that do not support the get_authToken message.

Attributes & Children
authInfo – This required argument is an element that contains an authentication token. Authentication tokens are obtained using the get_authToken message.
Return Types

Upon successful completion, the server returns a dispositionReport is returned with a single success indicator. Discarding an expired authToken will be reported as a success condition.

Errors

If an error occurs in processing this message, a dispositionReport structure will be returned to the caller in a SOAP Fault. The following error information will be relevant:

Error Code | Description
--- | ---
E_authTokenRequired | signifies that the authentication token value passed in the authInfo argument is either missing or is not valid.