Gets the current authentication state of an authenticated identities as well as the identity's current position in the authentication process for a specified service.
The identity handle for which authentication state information is being queried.
An HRESULT value that indicates the current authentication state of the identity. This value can indicate either that the identity is unauthenticated or the means by which the identity is authenticated. The following table describes the values that can be returned in this parameter.
The identity has not been authenticated.
Not used. Always returns 0.
An HRESULT value indicating the status of the most recent request. If there was an authentication error, the value returned in this parameter will describe the specific problem, such as an attempt to sign in by using an incorrect password.
A URL that indicates the address of the web page that will enable the user to take the next step to complete authentication. If a value is present in this output parameter, the client application should start a browser and go to this URL.
The following table describes the return values for this method.
The authentication state of the identity was successfully retrieved.
No information was found for the given target service. Usually means that no attempt to authenticate the user has been made in the current IDCRL session.