←Select platform

GetAuthenticationData Method

Summary

Enables an application to retrieve the authentication data previously stored for a particular user's logon name from the authentication repository.

Syntax

C++

string GetAuthenticationData(  
   int coupon, 
   string logonName, 
   string dataFormat, 
   string appSignature, 
   out string userData 
)

Function GetAuthenticationData( _ 
   ByVal coupon As Integer, _ 
   ByVal logonName As String, _ 
   ByVal dataFormat As String, _ 
   ByVal appSignature As String, _ 
   ByRef userData As String _ 
) As String

String^ GetAuthenticationData(  
   int coupon, 
   String^ logonName, 
   String^ dataFormat, 
   String^ appSignature, 
   [Out] String^ userData 
)

Parameters

coupon
The connection coupon obtain from the Connect method.

logonName
A user's logon name.

dataFormat
An application-defined string that is used when an application needs to maintain multiple forms of authentication data for a user (e.g., password, thumbprint image, etc.). If only one form of authentication data is needed, this string can be empty.

appSignature
The application's digital signature.

userData
Application-specific data used to authenticate the user.

Return Value

The digital signature of the authentication repository.

Remarks

Concatenating the string representations of the following inputs in the order listed shall form the data from which a message digest is computed by the application: