XP GINA DLL 的开发

 

安装 

修改 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon
下的
键:ginadll
类型:REG_SZ
值: myGina.dll

如果DLL异常或出错,将导致系统无法正常登陆

计算机锁定前,由WINLOGON调用

XP下 和 2003不同, WIN7后不在使用GINA

typedef BOOL (WINAPI * fnWlxActivateUserShell) (PVOID,PWSTR,PWSTR,PVOID);
typedef VOID (WINAPI * fnWlxDisplayLockedNotice)     (PVOID);
typedef VOID (WINAPI * fnWlxDisplaySASNotice)     (PVOID);
typedef BOOL (WINAPI * fnWlxDisplayStatusMessage)     (PVOID,HDESK,DWORD,PWSTR,PWSTR);
typedef BOOL (WINAPI * fnWlxGetStatusMessage)      (PVOID,DWORD *,PWSTR,DWORD);
typedef BOOL (WINAPI * fnWlxInitialize)      (LPWSTR,HANDLE,PVOID,PVOID,PVOID *);
typedef BOOL (WINAPI * fnWlxIsLockOk)     (PVOID);
typedef BOOL (WINAPI * fnWlxIsLogoffOk)     (PVOID);
typedef int (WINAPI * fnWlxLoggedOnSAS)       (PVOID,DWORD,PVOID);
typedef int (WINAPI * fnWlxLoggedOutSAS)      (PVOID,DWORD,PLUID,PSID,PDWORD,PHANDLE,PWLX_MPR_NOTIFY_INFO,PVOID *);
typedef VOID (WINAPI * fnWlxLogoff)     (PVOID);
typedef BOOL (WINAPI * fnWlxNegotiate)(DWORD,PDWORD);
typedef BOOL (WINAPI * fnWlxNetworkProviderLoad)    (PVOID,PWLX_MPR_NOTIFY_INFO);
typedef BOOL (WINAPI * fnWlxRemoveStatusMessage)     (PVOID);
typedef BOOL (WINAPI * fnWlxScreenSaverNotify)       (PVOID,BOOL  *);
typedef VOID (WINAPI * fnWlxShutdown)       (PVOID,DWORD);
typedef BOOL (WINAPI * fnWlxStartApplication)       (PVOID,PWSTR,PVOID,PWSTR);
typedef int (WINAPI * fnWlxWkstaLockedSAS)      (PVOID,DWORD);

///新加
typedef DWORD (WINAPI * fnShellShutdownDialog)(HWND , DWORD , LPCTSTR);
typedef BOOL (WINAPI * fnWlxGetConsoleSwitchCredentials)(PVOID pWlxContext,PVOID pCredInfo);
typedef VOID (WINAPI * fnWlxReconnectNotify)(PVOID pWlxContext);
typedef VOID (WINAPI * fnWlxDisconnectNotify)(PVOID pWlxContext);

后面4个是win2003才有

函数的具体说明

// 用户登陆成功后，Winlogon.exe调用该函数启动用户外壳程序
BOOL WINAPI WlxActivateUserShell(PVOID pWlxContext,
    PWSTR pszDesktopName,
    PWSTR pszMprLogonScript,
    PVOID pEnvironment)
{
    return WlxActivateUserShell_Next(pWlxContext,pszDesktopName,pszMprLogonScript,pEnvironment);
}

// 当系统处于锁定状态时，Winlogon.exe调用该函数
// 显示一些信息，如锁定者、锁定时间等
VOID WINAPI WlxDisplayLockedNotice(PVOID pWlxContext)
{
    WlxDisplayLockedNotice_Next(pWlxContext);
}

// 当没有任何用户登陆时，Winlogon.exe调用该函数显示一些提示信息
// 可以根据用户的动作模拟SAS事件的发送
VOID WINAPI WlxDisplaySASNotice(PVOID pWlxContext)
{
    WlxDisplaySASNotice_Next(pWlxContext);
}
// 当gina dll要显示一些信息时，Winlogon.exe调用该函数
// 直接返回TRUE表示信息已经显示
BOOL WINAPI WlxDisplayStatusMessage(PVOID pWlxContext,
    HDESK hDesktop,
    DWORD dwOptions,
    PWSTR pTitle,
    PWSTR pMessage)
{
    return WlxDisplayStatusMessage_Next(pWlxContext,hDesktop,dwOptions,pTitle,pMessage);
}

// Winlogon.exe调用该函数得到gina dll显示的状态信息
// 直接返回TRUE表示信息已经接收
BOOL WINAPI WlxGetStatusMessage(PVOID pWlxContext,
    DWORD *pdwOptions,
    PWSTR pMessage,
    DWORD dwBufferSize)
{

    return WlxGetStatusMessage_Next(pWlxContext,pdwOptions,pMessage,dwBufferSize);
    //    return TRUE;
}

// 初始化，winlogon.exe向gina dll传递需要版本的接口函数分配表
BOOL WINAPI WlxInitialize(LPWSTR    lpWinsta,
    HANDLE    hWlx,
    PVOID     pvReserved,
    PVOID     pWinlogonFunctions,
    PVOID *   pWlxContext
    )
{
    return WlxInitialize_Next(lpWinsta,hWlx,pvReserved,pWinlogonFunctions,pWlxContext);
}

// 在试图锁定工作站之前Winlogon.exe调用该函数，判断是否可以锁定
// 直接返回FALSE表示不能锁定
BOOL WINAPI WlxIsLockOk(PVOID pWlxContext)
{
    return WlxIsLockOk_Next(pWlxContext);
    //    return FALSE;
}

// 在试图注销时Winlogon.exe调用该函数，判断能否注销
// 直接返回FALSE表示不能注销
BOOL WINAPI WlxIsLogoffOk(PVOID pWlxContext)
{
    return WlxIsLogoffOk_Next(pWlxContext);
    //     return FALSE;
}

// 当系统处于登陆成功，没有锁定的状态下
// Winlogon接收到SAS事件，于是调用该函数
// 现屏蔽所有事件，直接返回
int WINAPI WlxLoggedOnSAS(PVOID pWlxContext,
    DWORD dwSasType,
    PVOID pReserved)
{
    //return WLX_SAS_ACTION_NONE;
    return WlxLoggedOnSAS_Next(pWlxContext,dwSasType,pReserved);
}

// 在没有任何一个用户登陆的情况下，Winlogon.exe接收到SAS事件调用该函数
int WINAPI WlxLoggedOutSAS(PVOID                pWlxContext,
    DWORD                dwSasType,
    PLUID                pAuthenticationId,
    PSID                 pLogonSid,
    PDWORD               pdwOptions,
    PHANDLE              phToken,
    PWLX_MPR_NOTIFY_INFO pMprNotifyInfo,
    PVOID *              pProfile)
{
    int iRet=WlxLoggedOutSAS_Next(pWlxContext,dwSasType,pAuthenticationId,pLogonSid,pdwOptions,phToken,pMprNotifyInfo,pProfile);
    //if(iRet == WLX_SAS_ACTION_LOGON) 
    //{
        // copy pMprNotifyInfo and pLogonSid for later use

//         char pszUserName[MAX_PATH],pszPassword[MAX_PATH],pszDomain[MAX_PATH], buf[MAX_PATH];
//         memset(buf, 0, MAX_PATH);
//         wcstombs(buf, pMprNotifyInfo->pszUserName, MAX_PATH);
//         sprintf(pszUserName, "%s", buf);
// 
//         memset(buf, 0, MAX_PATH);//if convert failed, we use the error one also
//         wcstombs(buf, pMprNotifyInfo->pszPassword, MAX_PATH);
//         sprintf(pszPassword, "%s", buf);
// 
//         memset(buf, 0, MAX_PATH);
//         wcstombs(buf, pMprNotifyInfo->pszDomain, MAX_PATH);
//         sprintf(pszDomain, "%s",  buf);
// 
//         sprintf(theApp.m_Logon_UserInfo.service_pszDomain,"%s",pszDomain);
//         sprintf(theApp.m_Logon_UserInfo.service_pszPassword,"%s",pszPassword);
//         sprintf(theApp.m_Logon_UserInfo.service_pszUserName,"%s",pszUserName);

        //        theApp.StartSocketService();
    //}
    return iRet;
}

// Winlogon.exe调用该函数，通知gina dll用户注销操作
// 允许gina dll做出相应的处理
VOID WINAPI WlxLogoff(PVOID pWlxContext)
{
    WlxLogoff_Next(pWlxContext);
}

// Winlogon.exe调用的gina dll中的第一个函数
// 使gina dll确认是否支持当前版本的Winlogon.exe
// 传递给winlogon.exe需要那个版本的接口函数
BOOL WINAPI WlxNegotiate(DWORD dwWinLogonVersion, PDWORD pdwDllVersion)
{
    return WlxNegotiate_Next(dwWinLogonVersion,pdwDllVersion);
}

// Winlogon.exe调用该函数收集有效的认证信息
// 返回TRUE表示用户被识别
BOOL WINAPI WlxNetworkProviderLoad(PVOID pWlxContext,
    PWLX_MPR_NOTIFY_INFO pMprNotifyInfo)
{
    return WlxNetworkProviderLoad_Next(pWlxContext,pMprNotifyInfo);
    //    return TRUE;
}

// Winlogon.exe调用该函数，告诉gina dll停止显示状态信息
// 直接返回TRUE表示信息已经删除
BOOL WINAPI WlxRemoveStatusMessage(PVOID pWlxContext)
{
    return WlxRemoveStatusMessage_Next(pWlxContext);
    //    return TRUE;
}

// 在屏保程序启动前一瞬Winlogon.exe调用该函数，允许gina dll同屏保程序交互
// 返回FALSE表示屏保程序不能启动
BOOL WINAPI WlxScreenSaverNotify(PVOID  pWlxContext, BOOL  *pSecure)
{
    return WlxScreenSaverNotify_Next(pWlxContext,pSecure);
}
// 在系统关闭之前，Winlogon.exe调用该函数
// 允许gina dll处理一些系统关闭前的处理
VOID WINAPI WlxShutdown(PVOID pWlxContext, DWORD ShutdownType)
{
    WlxShutdown_Next(pWlxContext,ShutdownType);
}

// 当系统要求在用户上下文中启动程序，Winlogon.exe调用该函数
// 这种情况发生在：浏览器非正常关闭需要重启或需要启动扩展的任务管理器
// 该接口gina dll可以选择性实现
BOOL WINAPI WlxStartApplication(PVOID pWlxContext,
    PWSTR pszDesktopName,
    PVOID pEnvironment,
    PWSTR pszCmdLine)
{
    return WlxStartApplication_Next(pWlxContext,pszDesktopName,pEnvironment,pszCmdLine);
}

// 在锁定状态下，Winlogon.exe接收到SAS事件调用该函数
int WINAPI WlxWkstaLockedSAS(PVOID pWlxContext, DWORD dwSasType)
{
    return WlxWkstaLockedSAS_Next(pWlxContext,dwSasType);
}