Synopsis

Checks the status of credentials.

MIDL Mapping

HRESULT is_valid(
[out] IDispatch** expiry_time,
[in,out,optional] VARIANT* exceptionInfo,
[out,retval] VARIANT_BOOL* returnValue

Automation Mapping

Function is_valid(expiry_time As Object,
[exceptionInfo]) As Boolean

Description

This method returns TRUE if the credentials used are active at the time; that is, you did not call DITobj_PrincipalAuthenticator.logoff or destroy_current. If this method is called after DITobj_PrincipalAuthenticator.logoff(), FALSE is returned. If this method is called after destroy_current(), the CORBA::BAD_INV_ORDER exception is raised.

Return Values

The output expiry_time as a DITimeBase_UtcT object set to max.

Programming Example

This section contains the portions of an ActiveX client application that implement the following:

Listing 17-1 ActiveX Client Application That Uses Tuxedo-Style Authentication

Set objSecurityCurrent = objBootstrap.CreateObject("Tobj.SecurityCurrent")
Set objPrincipalAuthenticator = objSecurityCurrent.principal_authenticator

     AuthorityType = objPrincipalAuthenticator.get_auth_type
					     If AuthorityType = TOBJ_APPAUTH Then logonStatus = 
                                     oPrincipalAuthenticator.Logon(
                                     UserName,_
                                     ClientName,_
                                     SystemPassword,_
                                     UserPassword
                                     User Data)
End If

     objPrincipalAuthenticator.logoff()