WlxGetOption Documentation


Application Security Testing: An Integral Part of DevOps

This addin was contributed by Jiøí Kutálek.

Environment: Visual C++

GINA's WlxGetOption function is not well documented on MSDN. I need to write GINA using smartcards, so I wanted to get information about the smartcards inserted during logon. Simply said, I want to use WlxGetOption to get some information. But what parameters have the function? When you look into the MSDN, you'll see something like:

BOOL WlxGetOption( HANDLE hWlx, DWORD Option, ULONG_PTR* Value);

where hWlx is the Winlogon handle. Option is one of these:


Value = current value of the option

I don't think "current value of the option" is the exact definition. There are six options; does each option has the same type of current value? After experimenting, I found the the sense of the "Value" parameter:

The "Value" type always points to DWORD.

  1. When one of these {WLX_OPTION_USE_CTRL_ALT_DEL, WLX_OPTION_USE_SMART_CARD, WLX_OPTION_SMART_CARD_PRESENT} options is used, the return value is BOOLEAN:
      DWORD dwX = 0;
      g_pWlxFuncs->WlxGetOption( g_hWlx,
      if (dwX)
        LOG("User can log on using smartcard");
        LOG("User cannot use smartcard");
    I found no differences between these options {WLX_OPTION_USE_SMART_CARD, WLX_OPTION_SMART_CARD_PRESENT}. It always returns the same values. Option WLX_OPTION_USE_CTRL_ALT_DEL always returns TRUE(?).

  2. When the WLX_OPTION_CONTEXT_POINTER option is used, the return value is a pointer to the GINA context. (This context pointer is the value often used as an input parameter for GINA's function, such as WlxDisplaySASNotice, WlxLoggedOutSAS, and so forth...)

  3. When the WLX_OPTION_SMART_CARD_INFO option is used, the return value is a pointer to the WLX_SC_NOTIFICATION_INFO structure. This structure is defined in the newer version of WinWlx.h as:
      typedef struct _WLX_SC_NOTIFICATION_INFO {
        PWSTR   pszCard ;
        PWSTR   pszReader ;
        PWSTR   pszContainer ;
        PWSTR   pszCryptoProvider ;
    If the smartcard is not acceptable, the return value is NULL:
      dwX = 0;
      g_pWlxFuncs->WlxGetOption( g_hWlx,
      if (dwX==0) LOG("Smart card is not acceptable");
        LOG_FORMAT1("Card = %ws",pInfo->pszCard);
        LOG_FORMAT1("Reader = %ws",pInfo->pszReader);
        LOG_FORMAT1("Container = %ws",pInfo->pszContainer);
        LOG_FORMAT1("CSP = %ws",pInfo->pszCryptoProvider);
    The pszContainer value was allways NULL in my experiments(?).
    WlxGetOption ret
  4. When the WLX_OPTION_DISPATCH_TABLE_SIZE option is used, the return value is a dispatch table sized in bytes.

The code was tested on Windows 2000, and dispatch version WLX_VERSION_1_3. I hope this article will save time for someone who wants to use WlxGetOption and looks for documentation about it. If you have some other experiences or suggestions, please add your comment.



    Posted by Legacy on 10/29/2003 12:00am

    Originally posted by: chan


    Your info was really helpful to proceed.

    When i called the WlxGetOption with WLX_OPTION_SMART_CARD_INFO parameter, the third parameter had value 0.You have mentioned that this means "Smart card is not acceptable".

    What could be the problem and any suggestions to re ctify this.

    My smart card is working fine with MSGINA cert logon.

    Thanks a lot,

  • WlxGetOption Documentation

    Posted by Legacy on 09/16/2003 12:00am

    Originally posted by: Milan Spalek

    Great - your comments are very helpful 4 me! DEKUJU!!!

  • Problem with Smart Cards on WIn XP

    Posted by Legacy on 09/06/2003 12:00am

    Originally posted by: bfadi

    I made an new GINA.dll that use smart card for windows logon.
    It worke fine on Win2K but in XP it did not work. I could not get the message SAS_SC_INSERT !

    I put the folowing : SetOption(USE_SC,1)... But it did not work also.
    I found on the web that some people say that if the XP is not domain joined it will not support Smart Card logon !

    Please do you have any solution ?

  • Great!! Thanks

    Posted by Legacy on 08/06/2002 12:00am

    Originally posted by: Giuseppe Amato

    Thankyou for this article...

    I'm writing a Smartcard enabled GINA replacement (based on the Ginastub MSDN example).
    It's making me crazy, because everything is bad documented!(or not documented at all!)

    tanks again
    Giuseppe Amato

  • You must have javascript enabled in order to post comments.

Leave a Comment
  • Your email address will not be published. All fields are required.

Top White Papers and Webcasts

  • As all sorts of data becomes available for storage, analysis and retrieval - so called 'Big Data' - there are potentially huge benefits, but equally huge challenges...
  • The agile organization needs knowledge to act on, quickly and effectively. Though many organizations are clamouring for "Big Data", not nearly as many know what to do with it...
  • Cloud-based integration solutions can be confusing. Adding to the confusion are the multiple ways IT departments can deliver such integration...

Most Popular Programming Stories

More for Developers

RSS Feeds

Thanks for your registration, follow us on our social networks to keep up-to-date
We have made updates to our Privacy Policy to reflect the implementation of the General Data Protection Regulation.