IfmManage::fmVerifyLoginState
This method verifies that the user has entered a password if a password is set.
Syntax
HRESULT fmVerifyLoginState( BSTR bstrTitle, BOOL fDoLogin, BOOL fKeepFocusOnFail, BOOL *pfLoggedIn);
Parameters
- bstrTitle
- Unicode string that contains the title to display, usually the name of the application.
- fDoLogin
- Boolean that is set to TRUE if the user is not currently logged on and needs to be logged on, or to FALSE otherwise.
- fKeepFocusOnFail
- Boolean that indicates whether or not to keep the foreground focus if the log in fails. Set to TRUE if the current foreground focus should be kept, or to FALSE if not.
- pfLoggedIn
- Pointer to a Boolean that is set to TRUE if the user is logged on, or to FALSE otherwise.
Return Values
An appropriate HRESULT value is returned.