Source code of Windows XP (NT5)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

3175 lines
75 KiB

/*++
Copyright (c) 1999-2000 Microsoft Corporation
Module Name:
HelpMgr.cpp
Abstract:
HelpMgr.cpp : Implementation of CRemoteDesktopHelpSessionMgr
Author:
HueiWang 2/17/2000
--*/
#include "stdafx.h"
#include "global.h"
#include "policy.h"
#include "RemoteDesktopUtils.h"
//
// CRemoteDesktopHelpSessionMgr Static member variable
//
#define DEFAULT_UNSOLICATED_HELP_TIMEOUT IDLE_SHUTDOWN_PERIOD
CCriticalSection CRemoteDesktopHelpSessionMgr::gm_AccRefCountCS;
// Help Session ID to help session instance cache map
IDToSessionMap CRemoteDesktopHelpSessionMgr::gm_HelpIdToHelpSession;
// Pointer to GIT
LPGLOBALINTERFACETABLE g_GIT = NULL;
DWORD g_ResolverCookie = 0;
CCriticalSection g_GITLock;
//
// Expert logoff monitor list, this is used for cleanup at
// the shutdown time so we don't have any opened handle.
//
EXPERTLOGOFFMONITORLIST g_ExpertLogoffMonitorList;
VOID CALLBACK
ExpertLogoffCallback(
PVOID pContext,
BOOLEAN bTimerOrWaitFired
)
/*++
Routine Description:
This routine is invoked by thread pool when handle to rdsaddin is signal.
Parameters:
pContext : Pointer to user data.
bTimerOrWaitFired : TRUE if wait timeout, FALSE otherwise.
Return:
None.
Note :
Refer to MSDN RegisterWaitForSingleObject() for function parameters.
--*/
{
PEXPERTLOGOFFSTRUCT pExpertLogoffStruct = (PEXPERTLOGOFFSTRUCT)pContext;
BSTR bstrHelpedTicketId = NULL;
WINSTATIONINFORMATION ExpertWinStation;
DWORD ReturnLength;
DWORD dwStatus;
BOOL bSuccess;
MYASSERT( FALSE == bTimerOrWaitFired );
MYASSERT( NULL != pContext );
DebugPrintf(
_TEXT("ExpertLogoffCallback()...\n")
);
// Our wait is forever so can't be timeout.
if( FALSE == bTimerOrWaitFired )
{
if( NULL != pExpertLogoffStruct )
{
DebugPrintf(
_TEXT("Expert %d has logoff\n"),
pExpertLogoffStruct->ExpertSessionId
);
MYASSERT( NULL != pExpertLogoffStruct->hWaitObject );
MYASSERT( NULL != pExpertLogoffStruct->hWaitProcess );
MYASSERT( pExpertLogoffStruct->bstrHelpedTicketId.Length() > 0 );
MYASSERT( pExpertLogoffStruct->bstrWinStationName.Length() > 0 );
if( pExpertLogoffStruct->bstrWinStationName.Length() > 0 )
{
//
// Reset the winstation asap since rdsaddin might get kill
// and termsrv stuck on waiting for winlogon to exit and
// shadow won't terminate until termsrv reset the winstation
//
ZeroMemory( &ExpertWinStation, sizeof(ExpertWinStation) );
bSuccess = WinStationQueryInformation(
SERVERNAME_CURRENT,
pExpertLogoffStruct->ExpertSessionId,
WinStationInformation,
(PVOID)&ExpertWinStation,
sizeof(WINSTATIONINFORMATION),
&ReturnLength
);
if( TRUE == bSuccess || ERROR_CTX_CLOSE_PENDING == GetLastError() )
{
//
// Cases:
// 1) Termsrv mark Helper session as close pending and
// function will return FALSE.
// 2) If somehow, session ID is re-use, session name
// will change then we compare cached name.
// Both cases, we will force a reset, however, only hope
// shadow ended and if mobsync still up, session will
// take a long time to terminate.
//
if( FALSE == bSuccess || pExpertLogoffStruct->bstrWinStationName == CComBSTR(ExpertWinStation.WinStationName) )
{
DebugPrintf(
_TEXT("Resetting winstation name %s, id %d\n"),
pExpertLogoffStruct->bstrWinStationName,
pExpertLogoffStruct->ExpertSessionId
);
// don't wait for it to return, can't do much if this fail
WinStationReset(
SERVERNAME_CURRENT,
pExpertLogoffStruct->ExpertSessionId,
FALSE
);
DebugPrintf(
_TEXT("WinStationReset return %d\n"),
GetLastError()
);
}
}
else
{
DebugPrintf(
_TEXT("Expert logoff failed to get winstation name %d\n"),
GetLastError()
);
}
}
if( pExpertLogoffStruct->bstrHelpedTicketId.Length() > 0 )
{
//
// detach pointer from CComBSTR, we will free it after handling
// WM_HELPERRDSADDINEXIT, purpose of this is not to duplicate
// string again.
//
bstrHelpedTicketId = pExpertLogoffStruct->bstrHelpedTicketId.Detach();
DebugPrintf(
_TEXT("Posting WM_HELPERRDSADDINEXIT...\n")
);
PostThreadMessage(
_Module.dwThreadID,
WM_HELPERRDSADDINEXIT,
pExpertLogoffStruct->ExpertSessionId,
(LPARAM) bstrHelpedTicketId
);
}
//
// Remove from monitor list.
//
{
EXPERTLOGOFFMONITORLIST::LOCK_ITERATOR it = g_ExpertLogoffMonitorList.find(pExpertLogoffStruct);
if( it != g_ExpertLogoffMonitorList.end() )
{
g_ExpertLogoffMonitorList.erase(it);
}
else
{
MYASSERT(FALSE);
}
}
// Destructor will take care of closing handle
delete pExpertLogoffStruct;
}
}
return;
}
/////////////////////////////////////////////////////////////////////////////
DWORD
MonitorExpertLogoff(
IN LONG pidToWaitFor,
IN LONG expertSessionId,
IN BSTR bstrHelpedTicketId
)
/*++
Routine Description:
Monitor expert logoff, specifically, we wait on rdsaddin process handle, once
signal, we immediately notify resolver that expert has logoff.
Parameters:
pidToWaitFor : RDSADDIN PID
expertSessionId : TS session ID that rdsaddin is running.
bstrHelpedTickerId : Help ticket ID that expert is helping.
Returns:
ERROR_SUCCESS or error code.
--*/
{
HANDLE hRdsaddin = NULL;
DWORD dwStatus = ERROR_SUCCESS;
BOOL bSuccess;
PEXPERTLOGOFFSTRUCT pExpertLogoffStruct = NULL;
WINSTATIONINFORMATION ExpertWinStation;
DWORD ReturnLength;
DebugPrintf(
_TEXT("CServiceModule::RegisterWaitForExpertLogoff...\n")
);
pExpertLogoffStruct = new EXPERTLOGOFFSTRUCT;
if( NULL == pExpertLogoffStruct )
{
dwStatus = GetLastError();
goto CLEANUPANDEXIT;
}
ZeroMemory( &ExpertWinStation, sizeof(ExpertWinStation) );
bSuccess = WinStationQueryInformation(
SERVERNAME_CURRENT,
expertSessionId,
WinStationInformation,
(PVOID)&ExpertWinStation,
sizeof(WINSTATIONINFORMATION),
&ReturnLength
);
if( FALSE == bSuccess )
{
//
// what do we do, we still need to inform resolver of disconnect,
// but we will not be able to reset winstation
//
dwStatus = GetLastError();
DebugPrintf(
_TEXT("WinStationQueryInformation() failed with %d...\n"),
dwStatus
);
MYASSERT(FALSE);
}
else
{
pExpertLogoffStruct->bstrWinStationName = ExpertWinStation.WinStationName;
DebugPrintf(
_TEXT("Helper winstation name %s...\n"),
pExpertLogoffStruct->bstrWinStationName
);
}
//
// Open rdsaddin.exe, if failed, bail out and don't continue
// help.
//
pExpertLogoffStruct->hWaitProcess = OpenProcess( PROCESS_ALL_ACCESS, FALSE, pidToWaitFor );
if( NULL == pExpertLogoffStruct->hWaitProcess )
{
dwStatus = GetLastError();
DebugPrintf(
_TEXT( "OpenProcess() on rdsaddin %d failed with %d\n"),
pidToWaitFor,
dwStatus
);
goto CLEANUPANDEXIT;
}
pExpertLogoffStruct->ExpertSessionId = expertSessionId;
pExpertLogoffStruct->bstrHelpedTicketId = bstrHelpedTicketId;
//
// Register wait on rdsaddin process handle.
//
bSuccess = RegisterWaitForSingleObject(
&(pExpertLogoffStruct->hWaitObject),
pExpertLogoffStruct->hWaitProcess,
(WAITORTIMERCALLBACK) ExpertLogoffCallback,
pExpertLogoffStruct,
INFINITE,
WT_EXECUTEDEFAULT | WT_EXECUTEONLYONCE
);
if( FALSE == bSuccess )
{
dwStatus = GetLastError();
DebugPrintf(
_TEXT("RegisterWaitForSingleObject() failed with %d\n"),
dwStatus
);
}
else
{
// store this into monitor list
try {
g_ExpertLogoffMonitorList[pExpertLogoffStruct] = pExpertLogoffStruct;
}
catch(...) {
// Memory allocation failed
dwStatus = GetLastError();
}
}
CLEANUPANDEXIT:
if( ERROR_SUCCESS != dwStatus )
{
if( NULL != pExpertLogoffStruct )
{
// destructor will take care of closing handle
delete pExpertLogoffStruct;
}
}
DebugPrintf(
_TEXT( "MonitorExpertLogoff() return %d\n"),
dwStatus
);
return dwStatus;
}
VOID
CleanupMonitorExpertList()
/*++
Routine Description:
Routine to clean up all remaining expert logoff monitor list, this
should be done right before we shutdown so we don't have any handle
leak.
Parameters:
None.
Returns:
None.
--*/
{
EXPERTLOGOFFMONITORLIST::LOCK_ITERATOR it =
g_ExpertLogoffMonitorList.begin();
DebugPrintf(
_TEXT("CleanupMonitorExpertList() has %d left\n"),
g_ExpertLogoffMonitorList.size()
);
for(; it != g_ExpertLogoffMonitorList.end(); it++ )
{
if( NULL != (*it).second )
{
// destructor will take care of closing handle
delete (*it).second;
(*it).second = NULL;
}
}
g_ExpertLogoffMonitorList.erase_all();
return;
}
HRESULT
InitializeGlobalInterfaceTable()
/*++
Routine Description:
Initialize GIT interface.
Parameters:
None.
Returns.
--*/
{
CCriticalSectionLocker l(g_GITLock);
HRESULT hRes = S_OK;
if( NULL == g_GIT )
{
//
// Create global interface table
//
hRes = CoCreateInstance(
CLSID_StdGlobalInterfaceTable,
NULL,
CLSCTX_INPROC_SERVER,
IID_IGlobalInterfaceTable,
(LPVOID*)&g_GIT
);
}
return hRes;
}
HRESULT
UnInitializeGlobalInterfaceTable()
/*++
Routine Description:
Initialize GIT interface.
Parameters:
None.
Returns.
--*/
{
CCriticalSectionLocker l(g_GITLock);
if( NULL != g_GIT )
{
g_GIT->Release();
g_GIT = NULL;
}
return S_OK;
}
HRESULT
RegisterResolverWithGIT(
ISAFRemoteDesktopCallback* pResolver
)
/*++
Routine Description:
Register Resolver interface with GIT.
Parameter:
pResolver : Pointer to resolver.
Returns:
--*/
{
HRESULT hRes;
CCriticalSectionLocker l(g_GITLock);
MYASSERT(NULL != g_GIT);
//
// register resolver interface with GIT, resolver has some
// data structure that depends on single instance.
//
IUnknown* pResolveIUnknown = NULL;
hRes = pResolver->QueryInterface(
IID_IUnknown,
(void **)&pResolveIUnknown
);
if( SUCCEEDED(hRes) )
{
hRes = g_GIT->RegisterInterfaceInGlobal(
pResolveIUnknown,
IID_ISAFRemoteDesktopCallback,
&g_ResolverCookie
);
pResolveIUnknown->Release();
}
return hRes;
}
HRESULT
LoadResolverFromGIT(
OUT ISAFRemoteDesktopCallback** ppResolver
)
/*++
Routine Description:
Load resolver interface from Global Interface Table, Resolver has data that depends
on single instance.
Parameters:
ppResolver : Pointer to ISAFRemoteDesktopCallback* to receive Resolver pointer
Returns:
S_OK or error code.
--*/
{
HRESULT hr;
CCriticalSectionLocker l(g_GITLock);
if( g_GIT != NULL )
{
hr = g_GIT->GetInterfaceFromGlobal(
g_ResolverCookie,
IID_ISAFRemoteDesktopCallback,
(LPVOID *)ppResolver
);
}
else
{
hr = HRESULT_FROM_WIN32( ERROR_FILE_NOT_FOUND );
MYASSERT(FALSE);
}
return hr;
}
//-----------------------------------------------------------
HRESULT
ImpersonateClient()
/*
Routine Description:
Impersonate client
Parameter:
None.
Returns:
S_OK or return code from CoImpersonateClient
--*/
{
HRESULT hRes;
#if __WIN9XBUILD__
// CoImpersonateClient() on Win9x is not supported.
hRes = S_OK;
#else
hRes = CoImpersonateClient();
#endif
return hRes;
}
//-----------------------------------------------------------
void
EndImpersonateClient()
/*
Routine Description:
End impersonating client
Parameter:
None.
Returns:
S_OK or return code from CoRevertToSelf
--*/
{
#if __WIN9XBUILD__
#else
HRESULT hRes;
hRes = CoRevertToSelf();
MYASSERT( SUCCEEDED(hRes) );
#endif
return;
}
HRESULT
CRemoteDesktopHelpSessionMgr::AddHelpSessionToCache(
IN BSTR bstrHelpId,
IN CComObject<CRemoteDesktopHelpSession>* pIHelpSession
)
/*++
Routine Description:
Add help session object to global cache.
Parameters:
bstrHelpId : Help Session ID.
pIHelpSession : Pointer to help session object.
Returns:
S_OK.
E_UNEXPECTED
HRESULT_FROM_WIN32( ERROR_FILE_EXITS )
--*/
{
HRESULT hRes = S_OK;
IDToSessionMap::LOCK_ITERATOR it = gm_HelpIdToHelpSession.find( bstrHelpId );
if( it == gm_HelpIdToHelpSession.end() )
{
try {
DebugPrintf(
_TEXT("Adding Help Session %s to cache\n"),
bstrHelpId
);
gm_HelpIdToHelpSession[ bstrHelpId ] = pIHelpSession;
}
catch(...) {
hRes = E_UNEXPECTED;
MYASSERT( SUCCEEDED(hRes) );
throw;
}
}
else
{
hRes = HRESULT_FROM_WIN32( ERROR_FILE_EXISTS );
}
return hRes;
}
HRESULT
CRemoteDesktopHelpSessionMgr::ExpireUserHelpSessionCallback(
IN CComBSTR& bstrHelpId,
IN HANDLE userData
)
/*++
Routine Description:
Expire help session call back routine, refer to EnumHelpEntry()
Parameters:
bstrHelpId : ID of help session.
userData : Handle to user data.
Returns:
S_OK.
--*/
{
HRESULT hRes = S_OK;
DebugPrintf(
_TEXT("ExpireUserHelpSessionCallback() on %s...\n"),
(LPCTSTR)bstrHelpId
);
// Load Help Entry.
RemoteDesktopHelpSessionObj* pObj = LoadHelpSessionObj( NULL, bstrHelpId );
if( NULL != pObj )
{
//
// LoadHelpSessionObj() will release expired help session.
//
pObj->Release();
}
return hRes;
}
HRESULT
CRemoteDesktopHelpSessionMgr::LogoffUserHelpSessionCallback(
IN CComBSTR& bstrHelpId,
IN HANDLE userData
)
/*++
Routine Description:
Expire help session call back routine, refer to EnumHelpEntry()
Parameters:
bstrHelpId : ID of help session.
userData : Handle to user data.
Returns:
S_OK.
--*/
{
HRESULT hRes = S_OK;
DWORD dwLogoffSessionId = PtrToUlong(userData);
long lHelpSessionUserSessionId;
DebugPrintf(
_TEXT("LogoffUserHelpSessionCallback() on %s %d...\n"),
bstrHelpId,
dwLogoffSessionId
);
// Load Help Entry.
RemoteDesktopHelpSessionObj* pObj = LoadHelpSessionObj( NULL, bstrHelpId );
if( NULL != pObj )
{
//
// LoadHelpSessionObj() will release expired help session.
//
hRes = pObj->get_UserLogonId( &lHelpSessionUserSessionId );
if( SUCCEEDED(hRes) && (DWORD)lHelpSessionUserSessionId == dwLogoffSessionId )
{
DebugPrintf(
_TEXT("User Session has log off...\n")
);
// rely on helpassistant session logoff to notify
// resolver.
hRes = pObj->put_UserLogonId(UNKNOWN_LOGONID);
}
else if( pObj->GetHelperSessionId() == dwLogoffSessionId )
{
DebugPrintf(
_TEXT("Helper has log off...\n")
);
// Helper has logoff, invoke disconnect to clean up
// resolver state.
hRes = pObj->NotifyDisconnect();
}
DebugPrintf(
_TEXT("hRes = 0x%08x, lHelpSessionUserSessionId=%d\n"),
hRes,
lHelpSessionUserSessionId
);
pObj->Release();
}
// Always return success to continue on next help session
return S_OK;
}
HRESULT
CRemoteDesktopHelpSessionMgr::NotifyPendingHelpServiceStartCallback(
IN CComBSTR& bstrHelpId,
IN HANDLE userData
)
/*++
Routine Description:
Call back for NotifyPendingHelpServiceStartup, refer to EnumHelpEntry()
Parameters:
bstrHelpId : ID of help session.
userData : Handle to user data.
Returns:
S_OK.
-*/
{
HRESULT hRes = S_OK;
// DeleteHelp() will try to close the port and since we just startup,
// port is either invalid or not open, so we need manually delete
// expired help
RemoteDesktopHelpSessionObj* pObj = LoadHelpSessionObj( NULL, bstrHelpId, TRUE );
if( NULL != pObj )
{
if( TRUE == pObj->IsHelpSessionExpired() )
{
pObj->put_ICSPort( 0 );
pObj->DeleteHelp();
ReleaseAssistantAccount();
}
else
{
DWORD dwICSPort;
//
// re-open the port so connection can come in
//
dwICSPort = OpenPort( TERMSRV_TCPPORT );
//dwICSPort = OpenPort( htons(TERMSRV_TCPPORT) );
pObj->put_ICSPort( dwICSPort );
// We don't close the port until we are deleted.
}
pObj->Release();
}
return hRes;
}
void
CRemoteDesktopHelpSessionMgr::NotifyPendingHelpServiceStartup()
/*++
Description:
Go thru all pending help and notify pending help about
service startup.
Parameters:
None.
Returns:
None
--*/
{
try {
g_HelpSessTable.EnumHelpEntry(
NotifyPendingHelpServiceStartCallback,
NULL
);
}
catch(...) {
MYASSERT(FALSE);
throw;
}
return;
}
void
CRemoteDesktopHelpSessionMgr::TimeoutHelpSesion()
/*++
Routine Description:
Expire help session that has exceed its valid period.
Parameters:
None.
Returns:
None.
--*/
{
DebugPrintf(
_TEXT("TimeoutHelpSesion()...\n")
);
try {
g_HelpSessTable.EnumHelpEntry(
ExpireUserHelpSessionCallback,
(HANDLE)NULL
);
}
catch(...) {
MYASSERT(FALSE);
throw;
}
return;
}
void
CRemoteDesktopHelpSessionMgr::NotifyHelpSesionLogoff(
DWORD dwLogonId
)
/*++
Routine Description:
Parameters:
Returns:
--*/
{
DebugPrintf(
_TEXT("NotifyHelpSesionLogoff() %d...\n"),
dwLogonId
);
try {
g_HelpSessTable.EnumHelpEntry(
LogoffUserHelpSessionCallback,
UlongToPtr(dwLogonId)
);
}
catch(...) {
MYASSERT(FALSE);
throw;
}
return;
}
HRESULT
CRemoteDesktopHelpSessionMgr::DeleteHelpSessionFromCache(
IN BSTR bstrHelpId
)
/*++
Routine Descritpion:
Delete help session from global cache.
Parameters:
bstrHelpId : Help session ID to be deleted.
Returns:
S_OK.
HRESULT_FROM_WIN32( ERROR_FILE_NOT_FOUND )
--*/
{
HRESULT hRes = S_OK;
DebugPrintf(
_TEXT("DeleteHelpSessionFromCache() - %s\n"),
bstrHelpId
);
IDToSessionMap::LOCK_ITERATOR it = gm_HelpIdToHelpSession.find( bstrHelpId );
if( it != gm_HelpIdToHelpSession.end() )
{
gm_HelpIdToHelpSession.erase( it );
}
else
{
hRes = HRESULT_FROM_WIN32( ERROR_FILE_NOT_FOUND );
}
return hRes;
}
RemoteDesktopHelpSessionObj*
CRemoteDesktopHelpSessionMgr::LoadHelpSessionObj(
IN CRemoteDesktopHelpSessionMgr* pMgr,
IN BSTR bstrHelpSession,
IN BOOL bLoadExpiredHelp /* = FALSE */
)
/*++
Routine Description:
Find a pending help entry, routine will load from DB if not
yet loaded.
Parameters:
pMgr : Pointer to CRemoteDesktopHelpSessionMgr object that wants to
load this help session.
bstrHelpSession : Help entry ID interested.
Returns:
--*/
{
HRESULT hRes = S_OK;
PHELPENTRY pHelp = NULL;
RemoteDesktopHelpSessionObj* pHelpSessionObj = NULL;
IDToSessionMap::LOCK_ITERATOR it = gm_HelpIdToHelpSession.find( bstrHelpSession );
if( it != gm_HelpIdToHelpSession.end() )
{
DebugPrintf(
_TEXT("LoadHelpSessionObj() %s is in cache ...\n"),
bstrHelpSession
);
pHelpSessionObj = (*it).second;
// One more reference to this object.
pHelpSessionObj->AddRef();
}
else
{
DebugPrintf(
_TEXT("Loading Help Session %s\n"),
bstrHelpSession
);
// load from table
hRes = g_HelpSessTable.OpenHelpEntry(
bstrHelpSession,
&pHelp
);
if( SUCCEEDED(hRes) )
{
//
// Object return from CreateInstance() has ref. count of 1
//
hRes = CRemoteDesktopHelpSession::CreateInstance(
pMgr,
(pMgr) ? pMgr->m_bstrUserSid : NULL,
pHelp,
&pHelpSessionObj
);
if( SUCCEEDED(hRes) )
{
if( NULL != pHelpSessionObj )
{
hRes = AddHelpSessionToCache(
bstrHelpSession,
pHelpSessionObj
);
if( SUCCEEDED(hRes) )
{
//m_HelpListByLocal.push_back( bstrHelpSession );
it = gm_HelpIdToHelpSession.find( bstrHelpSession );
MYASSERT( it != gm_HelpIdToHelpSession.end() );
if( it == gm_HelpIdToHelpSession.end() )
{
hRes = E_UNEXPECTED;
MYASSERT( FALSE );
}
}
if( FAILED(hRes) )
{
// we have big problem here...
pHelpSessionObj->Release();
pHelpSessionObj = NULL;
}
else
{
// ignore error here, it is possible that owner account
// got deleted even session is still active, we will let
// resolver to fail.
pHelpSessionObj->ResolveTicketOwner();
}
}
else
{
MYASSERT(FALSE);
hRes = E_UNEXPECTED;
}
}
if( FAILED(hRes) )
{
MYASSERT( FALSE );
pHelp->Close();
}
}
}
//
// If automatically delete expired help, check and delete expired help
//
if( FALSE == bLoadExpiredHelp && pHelpSessionObj &&
TRUE == pHelpSessionObj->IsHelpSessionExpired() )
{
// If session is in help or pending user response,
// don't expire it, let next load to delete it.
if( UNKNOWN_LOGONID == pHelpSessionObj->GetHelperSessionId() )
{
// Delete it from data base and in memory cache
pHelpSessionObj->DeleteHelp();
ReleaseAssistantAccount();
pHelpSessionObj->Release();
pHelpSessionObj = NULL;
}
}
return pHelpSessionObj;
}
/////////////////////////////////////////////////////////////////////////////
//
// CRemoteDesktopHelpSessionMgr
//
STDMETHODIMP
CRemoteDesktopHelpSessionMgr::DeleteHelpSession(
IN BSTR HelpSessionID
)
/*++
Routine Description:
Delete a user created Help Session from our cached list.
Parameter:
HelpSessionID : Help Session ID returned from CreateHelpSession() or
CreateHelpSessionEx().
Returns:
S_OK Success.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) Help ID not found.
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) Help does not belong to user
--*/
{
HRESULT hRes = S_OK;
BOOL bInCache;
if( FALSE == _Module.IsSuccessServiceStartup() )
{
// service startup problem, return error code.
hRes = _Module.GetServiceStartupStatus();
DebugPrintf(
_TEXT("Service startup failed with 0x%x\n"),
hRes
);
return hRes;
}
if( NULL == HelpSessionID )
{
hRes = E_POINTER;
MYASSERT(FALSE);
return hRes;
}
DebugPrintf(
_TEXT("Delete Help Session %s\n"),
HelpSessionID
);
hRes = LoadUserSid();
MYASSERT( SUCCEEDED(hRes) );
RemoteDesktopHelpSessionObj* pHelpObj;
pHelpObj = LoadHelpSessionObj( this, HelpSessionID );
if( NULL != pHelpObj )
{
// Only original creator can delete his/her help session
//if( TRUE == pHelpObj->IsEqualSid(m_bstrUserSid) )
//{
// DeleteHelp will also delete entry in global cache.
pHelpObj->DeleteHelp();
ReleaseAssistantAccount();
//}
//else
//{
// hRes = HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED);
//}
// LoadHelpSessionObj() always AddRef().
pHelpObj->Release();
}
else
{
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND);
}
return hRes;
}
STDMETHODIMP
CRemoteDesktopHelpSessionMgr::CreateHelpSession(
IN BSTR bstrSessName,
IN BSTR bstrSessPwd,
IN BSTR bstrSessDesc,
IN BSTR bstrSessBlob,
OUT IRemoteDesktopHelpSession **ppIRemoteDesktopHelpSession
)
/*++
--*/
{
// No one is using this routine.
return E_NOTIMPL;
}
HRESULT
CRemoteDesktopHelpSessionMgr::CreateHelpSession(
IN BOOL bCacheEntry,
IN BSTR bstrSessName,
IN BSTR bstrSessPwd,
IN BSTR bstrSessDesc,
IN BSTR bstrSessBlob,
IN LONG UserLogonId,
IN BSTR bstrClientSid,
OUT RemoteDesktopHelpSessionObj **ppIRemoteDesktopHelpSession
)
/*++
Routine Description:
Create an instantiation of IRemoteDesktopHelpSession object, each instantiation represent
a RemoteDesktop Help Session.
Parameters:
bstrSessName : User defined Help Session Name, currently not used.
bstrSessPwd : User defined Help Session password.
bstrSessDesc : User defined Help Session Description, currently not used.
ppIRemoteDesktopHelpSession : return an IRemoteDesktopHelpSession object representing a Help Session
Returns:
S_OK
E_UNEXPECTED
SESSMGR_E_GETHELPNOTALLOW User not allow to get help
Other COM error.
Note:
Caller must check if client is allowed to get help
--*/
{
HRESULT hRes = S_OK;
DWORD dwStatus;
CComBSTR bstrGenSessPwd;
PHELPENTRY pHelp = NULL;
CComBSTR bstrHelpSessionId;
DWORD dwICSPort;
LONG MaxTicketExpiry;
CComObject<CRemoteDesktopHelpSession>* pInternalHelpSessionObj = NULL;
if( NULL == ppIRemoteDesktopHelpSession )
{
hRes = E_POINTER;
return hRes;
}
hRes = GenerateHelpSessionId( bstrHelpSessionId );
if( FAILED(hRes) )
{
return hRes;
}
DebugPrintf(
_TEXT("CreateHelpSession %s\n"),
bstrHelpSessionId
);
//
// Setup assistant account rights and encryption parameters.
//
hRes = AcquireAssistantAccount();
if( FAILED(hRes) )
{
return hRes;
}
hRes = g_HelpSessTable.CreateInMemoryHelpEntry(
bstrHelpSessionId,
&pHelp
);
if( FAILED(hRes) )
{
goto CLEANUPANDEXIT;
}
MYASSERT( NULL != pHelp );
//
// Open ICS port.
//
dwICSPort = OpenPort( TERMSRV_TCPPORT );
//dwICSPort = OpenPort( htons(TERMSRV_TCPPORT) );
//
// CRemoteDesktopHelpSession::CreateInstance() will load
// TS session ID and default RDS settings.
//
hRes = CRemoteDesktopHelpSession::CreateInstance(
this,
CComBSTR(bstrClientSid), // client SID that open this instance
pHelp,
&pInternalHelpSessionObj
);
if( SUCCEEDED(hRes) )
{
//
// Check to see if user define a session password, if
// not, generate a random one.
//
bstrGenSessPwd.Attach( bstrSessPwd );
if( 0 == bstrGenSessPwd.Length() )
{
LPTSTR pszSessPwd = NULL;
//
// Always detach or CComBSTR will try to free it.
//
bstrGenSessPwd.Detach();
GenerateRandomString( MAX_HELPACCOUNT_PASSWORD * sizeof(TCHAR), &pszSessPwd );
bstrGenSessPwd = pszSessPwd;
if( NULL != pszSessPwd )
{
LocalFree( pszSessPwd );
}
}
else
{
//
// Detach input from CComBSTR and make a copy of it
// otherwise destructor will free it which will be
// the inpute BSTR.
//
bstrGenSessPwd.Detach();
bstrGenSessPwd = bstrSessPwd;
}
hRes = pInternalHelpSessionObj->BeginUpdate();
if( FAILED(hRes) )
{
goto CLEANUPANDEXIT;
}
//
// Get default timeout value from registry, not a critical
// error, if we failed, we just default to 30 days
//
hRes = PolicyGetMaxTicketExpiry( &MaxTicketExpiry );
if( SUCCEEDED(hRes) && MaxTicketExpiry > 0 )
{
pInternalHelpSessionObj->put_TimeOut( MaxTicketExpiry );
}
hRes = pInternalHelpSessionObj->put_ICSPort( dwICSPort );
if( SUCCEEDED(hRes) )
{
hRes = pInternalHelpSessionObj->put_UserLogonId(UserLogonId);
}
if( SUCCEEDED(hRes) )
{
// user SID that created this help session
hRes = pInternalHelpSessionObj->put_UserSID(bstrClientSid);
}
if( SUCCEEDED(hRes) )
{
hRes = pInternalHelpSessionObj->put_HelpSessionPassword(
bstrGenSessPwd
);
}
if( SUCCEEDED(hRes) )
{
hRes = pInternalHelpSessionObj->put_HelpSessionName(
bstrSessName
);
}
if( SUCCEEDED(hRes) )
{
hRes = pInternalHelpSessionObj->put_HelpSessionDescription(
bstrSessDesc
);
}
if( SUCCEEDED(hRes) )
{
hRes = pInternalHelpSessionObj->put_HelpSessionCreateBlob(
bstrSessBlob
);
}
if( SUCCEEDED(hRes) )
{
hRes = pInternalHelpSessionObj->CommitUpdate();
}
if( FAILED(hRes) )
{
// ignore error and exit
(VOID)pInternalHelpSessionObj->AbortUpdate();
goto CLEANUPANDEXIT;
}
//
// Ignore error, we will let resolver fail.
pInternalHelpSessionObj->ResolveTicketOwner();
//
// We are adding entry to table and also our global object
// cache, to prevent deadlock or timing problem, lock
// global cache and let MemEntryToStorageEntry() lock table.
//
LockIDToSessionMapCache();
try {
if( bCacheEntry )
{
// convert a in-memory help to persistant help
hRes = g_HelpSessTable.MemEntryToStorageEntry( pHelp );
}
if( SUCCEEDED(hRes) )
{
// Add help session to global cache
hRes = AddHelpSessionToCache(
bstrHelpSessionId,
pInternalHelpSessionObj
);
if( SUCCEEDED(hRes) )
{
*ppIRemoteDesktopHelpSession = pInternalHelpSessionObj;
}
else
{
MYASSERT( hRes != HRESULT_FROM_WIN32(ERROR_FILE_EXISTS) );
}
}
}
catch(...) {
hRes = E_UNEXPECTED;
throw;
}
UnlockIDToSessionMapCache();
}
CLEANUPANDEXIT:
if( FAILED(hRes) )
{
ReleaseAssistantAccount();
ClosePort(dwICSPort);
if( NULL != pInternalHelpSessionObj )
{
// this will also release pHelp.
pInternalHelpSessionObj->Release();
}
}
return hRes;
}
BOOL
CRemoteDesktopHelpSessionMgr::CheckAccessRights(
CComObject<CRemoteDesktopHelpSession>* pIHelpSess
)
/*++
--*/
{
//
// NOTE: This function checks to make sure the caller is the user that
// created the Help Session. For Whistler, we enforce that Help
// Sessions only be created by apps running as SYSTEM. Once
// created, the creating app can pass the object to any other app
// running in any other context. This function will get in the
// way of this capability so it simply returns TRUE for now.
//
return TRUE;
BOOL bSuccess;
// only original creator or help assistant can
// access
bSuccess = pIHelpSess->IsEqualSid( m_bstrUserSid );
if( FALSE == bSuccess )
{
bSuccess = g_HelpAccount.IsAccountHelpAccount(
m_pbUserSid,
m_cbUserSid
);
if( FALSE == bSuccess )
{
bSuccess = pIHelpSess->IsEqualSid( g_LocalSystemSID );
}
}
#if DISABLESECURITYCHECKS
//
// This is for private testing without using pcHealth, flag is not define
// in build.
//
//
// For testing only, allow admin to invoke this call
//
if( FALSE == bSuccess )
{
DWORD dump;
if( SUCCEEDED(ImpersonateClient()) )
{
dump = IsUserAdmin(&bSuccess);
if( ERROR_SUCCESS != dump )
{
bSuccess = FALSE;
}
EndImpersonateClient();
}
}
#endif
return bSuccess;
}
STDMETHODIMP
CRemoteDesktopHelpSessionMgr::RetrieveHelpSession(
IN BSTR HelpSessionID,
OUT IRemoteDesktopHelpSession **ppIRemoteDesktopHelpSession
)
/*++
Routine Description:
Retrieve a help session based on ID.
Parameters:
HelpSessionID : Help Session ID returned from CreateHelpSession().
ppIRemoteDesktopHelpSession : Return Help Session Object for the Help Session.
Paramters:
S_OK Success
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) Help Session not found
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) Access Denied
E_POINTER Invalid argument
--*/
{
HRESULT hRes = S_OK;
if( FALSE == _Module.IsSuccessServiceStartup() )
{
// service startup problem, return error code.
hRes = _Module.GetServiceStartupStatus();
DebugPrintf(
_TEXT("Service startup failed with 0x%x\n"),
hRes
);
return hRes;
}
DebugPrintf(
_TEXT("RetrieveHelpSession %s\n"),
HelpSessionID
);
if( NULL != ppIRemoteDesktopHelpSession )
{
// only user sid when needed
hRes = LoadUserSid();
if( SUCCEEDED(hRes) )
{
RemoteDesktopHelpSessionObj* pObj = LoadHelpSessionObj( this, HelpSessionID );
if( NULL != pObj && !pObj->IsHelpSessionExpired() )
{
if( TRUE == CheckAccessRights(pObj) )
{
// LoadHelpSessionObj() AddRef() to object
*ppIRemoteDesktopHelpSession = pObj;
}
else
{
hRes = HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED);
// LoadHelpSessionObj() AddRef() to object
pObj->Release();
}
}
else
{
hRes = HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND);
}
}
}
else
{
hRes = E_POINTER;
}
DebugPrintf(
_TEXT("RetrieveHelpSession %s returns 0x%08x\n"),
HelpSessionID,
hRes
);
return hRes;
}
STDMETHODIMP
CRemoteDesktopHelpSessionMgr::VerifyUserHelpSession(
IN BSTR HelpSessionId,
IN BSTR bstrSessPwd,
IN BSTR bstrResolverConnectBlob,
IN BSTR bstrExpertBlob,
IN LONG CallerProcessId,
OUT ULONG_PTR* phHelpCtr,
OUT LONG* pResolverErrCode,
OUT long* plUserTSSession
)
/*++
Routine Description:
Verify a user help session is valid and invoke resolver to find the correct
user help session to provide help.
Parameters:
HelpSessionId : Help Session ID.
bstrSessPwd : Password to be compare.
bstrResolverConnectBlob : Optional parameter to be passed to resolver.
bstrExpertBlob : Optional blob to be passed to resolver for security check.
pResolverErrCode : Return code from resolver.
plUserTSSession : Current logon session.
Returns:
S_OK
--*/
{
HRESULT hRes;
CComBSTR bstrUserSidString;
BOOL bMatch;
BOOL bInCache = FALSE;
if( FALSE == _Module.IsSuccessServiceStartup() )
{
// service startup problem, return error code.
hRes = _Module.GetServiceStartupStatus();
DebugPrintf(
_TEXT("Service startup failed with 0x%x\n"),
hRes
);
*plUserTSSession = SAFERROR_SESSMGRERRORNOTINIT;
return hRes;
}
DebugPrintf(
_TEXT("VerifyUserHelpSession %s\n"),
HelpSessionId
);
if( NULL != plUserTSSession && NULL != pResolverErrCode && NULL != phHelpCtr )
{
hRes = LoadUserSid();
if( SUCCEEDED(hRes) )
{
RemoteDesktopHelpSessionObj* pObj = LoadHelpSessionObj( this, HelpSessionId );
if( NULL != pObj )
{
// Allow all user to invoke this call.
bMatch = pObj->VerifyUserSession(
CComBSTR(),
CComBSTR(bstrSessPwd)
);
if( TRUE == bMatch )
{
hRes = pObj->ResolveUserSession(
bstrResolverConnectBlob,
bstrExpertBlob,
CallerProcessId,
phHelpCtr,
pResolverErrCode,
plUserTSSession
);
}
else
{
hRes = HRESULT_FROM_WIN32(ERROR_INVALID_PASSWORD);
*pResolverErrCode = SAFERROR_INVALIDPASSWORD;
}
// LoadHelpSessionObj() AddRef() to object
pObj->Release();
}
else
{
hRes = HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND);
*pResolverErrCode = SAFERROR_HELPSESSIONNOTFOUND;
}
}
else
{
*pResolverErrCode = SAFERROR_INTERNALERROR;
}
}
else
{
hRes = E_POINTER;
*pResolverErrCode = SAFERROR_INVALIDPARAMETERSTRING;
}
return hRes;
}
STDMETHODIMP
CRemoteDesktopHelpSessionMgr::IsValidHelpSession(
/*[in]*/ BSTR HelpSessionId,
/*[in]*/ BSTR HelpSessionPwd
)
/*++
Description:
Verify if a help session exists and password match.
Parameters:
HelpSessionId : Help session ID.
HelpSessionPwd : Optional help session password
Returns:
Note:
Only allow system service and administrator to invoke this
call.
--*/
{
HRESULT hRes = S_OK;
BOOL bPasswordMatch;
RemoteDesktopHelpSessionObj* pObj;
if( FALSE == _Module.IsSuccessServiceStartup() )
{
// service startup problem, return error code.
hRes = _Module.GetServiceStartupStatus();
DebugPrintf(
_TEXT("Service startup failed with 0x%x\n"),
hRes
);
return hRes;
}
DebugPrintf(
_TEXT("IsValidHelpSession ID %s\n"),
HelpSessionId
);
hRes = LoadUserSid();
if( FAILED(hRes) )
{
goto CLEANUPANDEXIT;
}
hRes = ImpersonateClient();
if( FAILED(hRes) )
{
goto CLEANUPANDEXIT;
}
//
// Make sure only system service can invoke this call.
//
if( !g_pSidSystem || FALSE == IsCallerSystem(g_pSidSystem) )
{
#if DISABLESECURITYCHECKS
DWORD dump;
BOOL bStatus;
//
// For testing only, allow admin to invoke this call
//
dump = IsUserAdmin(&bStatus);
hRes = HRESULT_FROM_WIN32( dump );
if( FAILED(hRes) || FALSE == bStatus )
{
EndImpersonateClient();
hRes = HRESULT_FROM_WIN32( ERROR_ACCESS_DENIED );
goto CLEANUPANDEXIT;
}
#else
EndImpersonateClient();
hRes = HRESULT_FROM_WIN32( ERROR_ACCESS_DENIED );
goto CLEANUPANDEXIT;
#endif
}
// No need to run as client.
EndImpersonateClient();
pObj = LoadHelpSessionObj( this, HelpSessionId );
if( NULL != pObj )
{
CComBSTR bstrPassword;
bstrPassword.Attach(HelpSessionPwd);
if( bstrPassword.Length() > 0 )
{
bPasswordMatch = pObj->VerifyUserSession(
CComBSTR(),
CComBSTR(HelpSessionPwd)
);
if( FALSE == bPasswordMatch )
{
hRes = HRESULT_FROM_WIN32(ERROR_INVALID_PASSWORD);
}
}
bstrPassword.Detach();
pObj->Release();
}
else
{
hRes = HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND);
}
CLEANUPANDEXIT:
return hRes;
}
/////////////////////////////////////////////////////////////////////////////
//
CRemoteDesktopHelpSessionMgr::CRemoteDesktopHelpSessionMgr() :
//m_lAccountAcquiredByLocal(0),
m_pbUserSid(NULL),
m_cbUserSid(0)
/*++
CRemoteDesktopHelpSessMgr Constructor
--*/
{
}
void
CRemoteDesktopHelpSessionMgr::Cleanup()
/*++
Routine Description:
Cleanup resource allocated in CRemoteDesktopHelpSessionMgr
Parameters:
None.
Returns:
None.
--*/
{
if( m_pbUserSid )
{
LocalFree(m_pbUserSid);
m_pbUserSid = NULL;
}
}
//--------------------------------------------------------------
HRESULT
CRemoteDesktopHelpSessionMgr::LoadUserSid()
/*++
Routine Description:
Load client's SID onto class member variable m_pbUserSid,
m_cbUserSid, and m_bstrUserSid. We can't load user SID
at class constructor as COM still haven't retrieve information
about client's credential yey.
Parameters:
None.
Returns:
S_OK
error code from ImpersonateClient()
error code from GetTextualSid()
Note:
On Win9x machine, user SID is 'hardcoded WIN9X_USER_SID
--*/
{
#ifndef __WIN9XBUILD__
HRESULT hRes = S_OK;
// check if SID already loaded, if not continue
// on loading SID
if( NULL == m_pbUserSid || 0 == m_cbUserSid )
{
DWORD dwStatus;
BOOL bSuccess = TRUE;
LPTSTR pszTextualSid = NULL;
DWORD dwTextualSid = 0;
hRes = ImpersonateClient();
if( SUCCEEDED(hRes) )
{
m_LogonId = GetUserTSLogonId();
// retrieve user SID.
dwStatus = GetUserSid( &m_pbUserSid, &m_cbUserSid );
if( ERROR_SUCCESS == dwStatus )
{
m_bstrUserSid.Empty();
// convert SID to string
bSuccess = GetTextualSid(
m_pbUserSid,
NULL,
&dwTextualSid
);
if( FALSE == bSuccess && ERROR_INSUFFICIENT_BUFFER == GetLastError() )
{
pszTextualSid = (LPTSTR)LocalAlloc(
LPTR,
(dwTextualSid + 1) * sizeof(TCHAR)
);
if( NULL != pszTextualSid )
{
bSuccess = GetTextualSid(
m_pbUserSid,
pszTextualSid,
&dwTextualSid
);
if( TRUE == bSuccess )
{
m_bstrUserSid = pszTextualSid;
}
}
}
if( 0 == m_bstrUserSid.Length() )
{
hRes = HRESULT_FROM_WIN32(GetLastError());
}
}
if( NULL != pszTextualSid )
{
LocalFree(pszTextualSid);
}
EndImpersonateClient();
}
}
return hRes;
#else
m_pbUserSid = NULL;
m_cbUserSid = 0;
m_bstrUserSid = WIN9X_USER_SID;
return S_OK;
#endif
}
//---------------------------------------------------------------
HRESULT
CRemoteDesktopHelpSessionMgr::IsUserAllowToGetHelp(
OUT BOOL* pbAllow
)
/*++
Routine Description:
Check if connected user is allowed to GetHelp.
Parameters:
pbAllow : Return TRUE if user is allowed to GetHelp, FALSE otherwise.
Returns:
S_OK or error code.
Note:
GetHelp's priviledge is via group membership.
--*/
{
HRESULT hRes;
hRes = ImpersonateClient();
if( SUCCEEDED(hRes) )
{
CComBSTRtoLPTSTR string( m_bstrUserSid );
*pbAllow = ::IsUserAllowToGetHelp( GetUserTSLogonId(), (LPCTSTR) string );
hRes = S_OK;
}
else
{
// can't get help if impersonate failed.
*pbAllow = FALSE;
}
EndImpersonateClient();
return hRes;
}
//---------------------------------------------------------
HRESULT
CRemoteDesktopHelpSessionMgr::AcquireAssistantAccount()
/*++
Routine Description:
"Acquire", increase the reference count of RemoteDesktop Assistant account.
Routine creates a 'well-known' assistant account If is not exist or
enables/change password if the account is disabled.
Help Account Manager will automatically release all reference count
acquire by a particular session when user log off to prevent this account
been 'locked'.
Parameters:
pvarAccountName
Pointer to BSTR to receive RemoteDesktop Assistant account name.
pvarAccountPwd
Pointer to BSTR to receive RemoteDesktop Assistant account password.
Returns:
Success or error code.
Note:
This is also the conference name and conference password
when NetMeeting is used to share user desktop.
--*/
{
HRESULT hRes = S_OK;
DWORD dwStatus;
CCriticalSectionLocker l( gm_AccRefCountCS );
#ifndef __WIN9xBUILD__
//
// Always enable interactive rights.
//
hRes = g_HelpAccount.EnableRemoteInteractiveRight(TRUE);
if( FAILED(hRes) )
{
DebugPrintf(
_TEXT("Failed in EnableRemoteInteractiveRight() - 0x%08x\n"),
hRes
);
goto CLEANUPANDEXIT;
}
//
// Always enable the account in case user disable it.
//
hRes = g_HelpAccount.EnableHelpAssistantAccount( TRUE );
if( FAILED(hRes) )
{
DebugPrintf( _TEXT("Can't enable help assistant account 0x%x\n"), hRes );
goto CLEANUPANDEXIT;
}
if( g_HelpSessTable.NumEntries() == 0 )
{
DebugPrintf(
_TEXT("Setting encryption parameters...\n")
);
dwStatus = TSHelpAssistantBeginEncryptionCycle();
hRes = HRESULT_FROM_WIN32( dwStatus );
MYASSERT( SUCCEEDED(hRes) );
//
// Setup account TS setting via WTSAPI
//
hRes = g_HelpAccount.SetupHelpAccountTSSettings();
if( SUCCEEDED(hRes) )
{
DebugPrintf(
_TEXT("SetupHelpAccountTSSettings return 0x%08x\n"),
hRes
);
}
else
{
DebugPrintf( _TEXT("SetupHelpAccountTSSettings failed with 0x%08x\n"), hRes );
}
}
#endif
CLEANUPANDEXIT:
return hRes;
}
//----------------------------------------------------------
HRESULT
CRemoteDesktopHelpSessionMgr::ReleaseAssistantAccount()
/*++
Routine Description:
Release RemoteDesktop assistant account previously
acquired with AcquireAssistantAccount(),
account will be disabled if the account reference
count is 0.
Help Account Manager will automatically release all
reference count acquire by a particular session when
user log off to prevent this account been 'locked'.
Parameters:
None
Returns:
Success or error code.
--*/
{
HRESULT hRes = S_OK;
DWORD dwStatus;
CCriticalSectionLocker l( gm_AccRefCountCS );
#ifndef __WIN9XBUILD__
if( g_HelpSessTable.NumEntries() == 0 )
{
// ignore error if we can't reset account password
(void)g_HelpAccount.ResetHelpAccountPassword();
dwStatus = TSHelpAssisantEndEncryptionCycle();
hRes = HRESULT_FROM_WIN32( dwStatus );
MYASSERT( SUCCEEDED(hRes) );
//
// diable HelpAssistant TS 'Connect' right.
//
g_HelpAccount.EnableRemoteInteractiveRight(FALSE);
hRes = g_HelpAccount.EnableHelpAssistantAccount( FALSE );
if( FAILED(hRes) )
{
// not a critical error.
DebugPrintf( _TEXT("Can't disable help assistant account 0x%x\n"), hRes );
}
}
#endif
return S_OK;
}
STDMETHODIMP
CRemoteDesktopHelpSessionMgr::GetUserSessionRdsSetting(
OUT REMOTE_DESKTOP_SHARING_CLASS* rdsLevel
)
/*++
--*/
{
HRESULT hRes;
DWORD dwStatus;
REMOTE_DESKTOP_SHARING_CLASS userRdsDefault;
if( NULL != rdsLevel )
{
hRes = ImpersonateClient();
if( SUCCEEDED(hRes) )
{
hRes = LoadUserSid();
MYASSERT( SUCCEEDED(hRes) );
dwStatus = GetUserRDSLevel( m_LogonId, &userRdsDefault );
hRes = HRESULT_FROM_WIN32( dwStatus );
*rdsLevel = userRdsDefault;
EndImpersonateClient();
}
}
else
{
hRes = E_POINTER;
}
return hRes;
}
STDMETHODIMP
CRemoteDesktopHelpSessionMgr::ResetHelpAssistantAccount(
BOOL bForce
)
/*++
Routine Description:
Reset help assistant account password.
Parameters:
bForce : TRUE if delete all pending help and reset the account password, FALSE
if reset account password if there is no more pending help session.
Returns:
S_OK
HRESULT_FROM_WIN32( ERROR_MORE_DATA )
--*/
{
HRESULT hRes = S_OK;
hRes = LoadUserSid();
MYASSERT( SUCCEEDED(hRes) );
// Check any help stil pending
if( g_HelpSessTable.NumEntries() > 0 )
{
if( FALSE == bForce )
{
hRes = HRESULT_FROM_WIN32( ERROR_MORE_DATA );
}
else
{
IDToSessionMap::LOCK_ITERATOR it = gm_HelpIdToHelpSession.begin();
//
// notify all in cached pending help session that it has been deleted.
// rest help entry will be deleted via DeleteSessionTable().
for( ;it != gm_HelpIdToHelpSession.end(); )
{
RemoteDesktopHelpSessionObj* pObj = (*it).second;
// DeleteHelp() will wipe entry from cache.
it++;
// We can't not release this object since client might still
// holding pointer
pObj->DeleteHelp();
}
g_HelpSessTable.DeleteSessionTable();
}
}
if(SUCCEEDED(hRes))
{
hRes = g_HelpAccount.ResetHelpAccountPassword();
}
return hRes;
}
HRESULT
CRemoteDesktopHelpSessionMgr::GenerateHelpSessionId(
CComBSTR& bstrHelpSessionId
)
/*++
Routine Description:
Create a unique Help Session ID.
Parameters:
bstrHelpSessionId : Reference to CComBSTR to receive HelpSessionId.
Returns:
S_OK
HRESULT_FROM_WIN32( Status from RPC call UuidCreate() or UuidToString() )
--*/
{
LPTSTR pszRandomString = NULL;
DWORD dwStatus;
dwStatus = GenerateRandomString( 32, &pszRandomString );
if( ERROR_SUCCESS == dwStatus )
{
bstrHelpSessionId = pszRandomString;
LocalFree( pszRandomString );
}
return HRESULT_FROM_WIN32( dwStatus );
}
STDMETHODIMP
CRemoteDesktopHelpSessionMgr::CreateHelpSessionEx(
/*[in]*/ REMOTE_DESKTOP_SHARING_CLASS sharingClass,
/*[in]*/ BOOL fEnableCallback,
/*[in]*/ LONG timeOut,
/*[in]*/ LONG userSessionId,
/*[in]*/ BSTR userSid,
/*[in]*/ BSTR bstrUserHelpCreateBlob,
/*[out, retval]*/ IRemoteDesktopHelpSession** ppIRemoteDesktopHelpSession
)
/*++
Routine Description:
Simimar to CreateHelpSession() except it allow caller to assoicate a
help session to a specific user, caller must be running in
system context.
Parameters:
sharingClass : Level of remote control (shadow setting) needed.
fEnableCallback : TRUE to enable resolver callback, FALSE otherwise.
timeOut : Help session timeout value.
userSessionId : Logon user TS session ID.
userSid : User SID that help session associated.
bstrUserHelpCreateBlob : user specific create blob.
parms: Return connect parm.
Returns:
--*/
{
HRESULT hRes;
RemoteDesktopHelpSessionObj* pRemoteDesktopHelpSessionObj = NULL;
if( NULL == ppIRemoteDesktopHelpSession )
{
hRes = E_POINTER;
}
else
{
hRes = RemoteCreateHelpSessionEx(
TRUE, // cache entry
fEnableCallback, // enable resolver ?
sharingClass,
(timeOut == 0) ? EXPIRE_HELPSESSION_PERIOD : timeOut,
userSessionId,
userSid,
bstrUserHelpCreateBlob,
&pRemoteDesktopHelpSessionObj
);
//
// 1) pcHealth resolver interprete salem connection parm, reset help session name to
// some default string.
// 2) When resolver invoke helpctr, script will truncate up to first space so
// our name can not contain space.
//
if( SUCCEEDED(hRes) && pRemoteDesktopHelpSessionObj )
{
ULONG flag;
hRes = pRemoteDesktopHelpSessionObj->put_HelpSessionName( HELPSESSION_NORMAL_RA );
if( SUCCEEDED(hRes) )
{
hRes = pRemoteDesktopHelpSessionObj->put_HelpSessionDescription( HELPSESSION_NORMAL_RA );
}
if( FAILED(hRes) )
{
pRemoteDesktopHelpSessionObj->Release();
pRemoteDesktopHelpSessionObj = NULL;
}
flag = pRemoteDesktopHelpSessionObj->GetHelpSessionFlag();
pRemoteDesktopHelpSessionObj->SetHelpSessionFlag( flag & ~HELPSESSIONFLAG_UNSOLICITEDHELP );
}
*ppIRemoteDesktopHelpSession = pRemoteDesktopHelpSessionObj;
}
return hRes;
}
STDMETHODIMP
CRemoteDesktopHelpSessionMgr::RemoteCreateHelpSession(
/*[in]*/ REMOTE_DESKTOP_SHARING_CLASS sharingClass,
/*[in]*/ LONG timeOut,
/*[in]*/ LONG userSessionId,
/*[in]*/ BSTR userSid,
/*[in]*/ BSTR bstrHelpCreateBlob,
/*[out, retval]*/ BSTR* parms
)
/*++
Description:
UNSOLICTED SUPPORT, only invoke by PCHEALTH, differ to CreateHelpSessionEx()
are help session entry will not cached into registry and resolver callback is
always enable.
Parameters:
Refer to CreateHelpSessionEx().
Returns:
--*/
{
HRESULT hRes;
RemoteDesktopHelpSessionObj* pIRemoteDesktopHelpSession = NULL;
// if pcHealth pass unresolve session, cache the entry, set
// timeout to very short for security reason.
hRes = RemoteCreateHelpSessionEx(
FALSE, // don't cache entry in registry.
TRUE, // force resolver call.
sharingClass,
(timeOut == 0) ? DEFAULT_UNSOLICATED_HELP_TIMEOUT : timeOut,
userSessionId,
userSid,
bstrHelpCreateBlob,
&pIRemoteDesktopHelpSession
);
if( SUCCEEDED(hRes) && NULL != pIRemoteDesktopHelpSession )
{
hRes = pIRemoteDesktopHelpSession->get_ConnectParms( parms );
}
return hRes;
}
HRESULT
CRemoteDesktopHelpSessionMgr::RemoteCreateHelpSessionEx(
/*[in]*/ BOOL bCacheEntry,
/*[in]*/ BOOL bEnableResolver,
/*[in]*/ REMOTE_DESKTOP_SHARING_CLASS sharingClass,
/*[in]*/ LONG timeOut,
/*[in]*/ LONG userSessionId,
/*[in]*/ BSTR userSid,
/*[in]*/ BSTR bstrHelpCreateBlob,
/*[out, retval]*/ RemoteDesktopHelpSessionObj** ppIRemoteDesktopHelpSession
)
/*++
Routine Description:
Create help ticket and return connection parameters.
Parameters:
bCacheEntry : Cache help session to registry.
bEnableCallback : TRUE to enable resolver callback, FALSE otherwise.
sharingClass : RDS setting requested.
timeout : Help session expiry period.
userSessionId : User TS session ID that help session associated with.
userSid : SID of user on the TS session.
bstrHelpCreateBlob : User specific help session create blob, meaningless
if resolver is not enabled.
ppIRemoteDesktopHelpSession : Help session created.
Returns:
S_OK
S_FALSE sharingClass violate policy setting.
other error code.
--*/
{
HRESULT hRes = S_OK;
BOOL bStatus;
RemoteDesktopHelpSessionObj *pIHelpSession = NULL;
BOOL bAllowGetHelp = FALSE;
ULONG flag;
#if DBG
long HelpSessLogonId;
#endif
if( FALSE == _Module.IsSuccessServiceStartup() )
{
// service startup problem, return error code.
hRes = _Module.GetServiceStartupStatus();
DebugPrintf(
_TEXT("Service startup failed with 0x%x\n"),
hRes
);
goto CLEANUPANDEXIT;
}
if( 0 == timeOut )
{
hRes = E_INVALIDARG;
MYASSERT(FALSE);
goto CLEANUPANDEXIT;
}
hRes = LoadUserSid();
if( FAILED(hRes) )
{
goto CLEANUPANDEXIT;
}
// common routine in tsremdsk.lib
if( FALSE == TSIsMachinePolicyAllowHelp() )
{
hRes = HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED);
goto CLEANUPANDEXIT;
}
hRes = ImpersonateClient();
if( FAILED(hRes) )
{
goto CLEANUPANDEXIT;
}
//
// Make sure only system service can invoke this call.
//
if( !g_pSidSystem || FALSE == IsCallerSystem(g_pSidSystem) )
{
#if DISABLESECURITYCHECKS
DWORD dump;
//
// For testing only, allow admin to invoke this call
//
dump = IsUserAdmin(&bStatus);
hRes = HRESULT_FROM_WIN32( dump );
if( FAILED(hRes) || FALSE == bStatus )
{
EndImpersonateClient();
hRes = HRESULT_FROM_WIN32( ERROR_ACCESS_DENIED );
goto CLEANUPANDEXIT;
}
#else
EndImpersonateClient();
hRes = HRESULT_FROM_WIN32( ERROR_ACCESS_DENIED );
goto CLEANUPANDEXIT;
#endif
}
// No need to run as client.
EndImpersonateClient();
//
// No ERROR checking on userSessionId and userSid, pcHealth
// will make sure all parameter is correct
//
//
// Create a Help Session.
//
hRes = CreateHelpSession(
bCacheEntry,
HELPSESSION_UNSOLICATED,
CComBSTR(""),
HELPSESSION_UNSOLICATED,
bstrHelpCreateBlob,
(userSessionId == -1) ? UNKNOWN_LOGONID : userSessionId,
userSid,
&pIHelpSession
);
if( FAILED(hRes) )
{
goto CLEANUPANDEXIT;
}
if( NULL == pIHelpSession )
{
MYASSERT( NULL != pIHelpSession );
hRes = E_UNEXPECTED;
goto CLEANUPANDEXIT;
}
#if DBG
hRes = pIHelpSession->get_UserLogonId( &HelpSessLogonId );
MYASSERT( SUCCEEDED(hRes) );
if( userSessionId != -1 )
{
MYASSERT( HelpSessLogonId == userSessionId );
}
else
{
MYASSERT( HelpSessLogonId == UNKNOWN_LOGONID );
}
#endif
//
// setup help session parms.
//
hRes = pIHelpSession->put_EnableResolver(bEnableResolver);
MYASSERT( SUCCEEDED(hRes) );
if( FAILED(hRes) )
{
goto CLEANUPANDEXIT;
}
hRes = pIHelpSession->put_TimeOut( timeOut );
if( FAILED(hRes) )
{
DebugPrintf(
_TEXT("put_TimeOut() failed with 0x%08x\n"),
hRes
);
goto CLEANUPANDEXIT;
}
//
// We change default RDS value at the end so we can return error code or S_FALSE
// from this.
//
hRes = pIHelpSession->put_UserHelpSessionRemoteDesktopSharingSetting( sharingClass );
if( FAILED( hRes) )
{
DebugPrintf(
_TEXT("put_UserHelpSessionRemoteDesktopSharingSetting() failed with 0x%08x\n"),
hRes
);
}
flag = pIHelpSession->GetHelpSessionFlag();
pIHelpSession->SetHelpSessionFlag( flag | HELPSESSIONFLAG_UNSOLICITEDHELP );
CLEANUPANDEXIT:
if( FAILED(hRes) )
{
if( NULL != pIHelpSession )
{
pIHelpSession->Release();
}
}
else
{
MYASSERT( NULL != pIHelpSession );
*ppIRemoteDesktopHelpSession = pIHelpSession;
}
return hRes;
}
HRESULT
LoadLocalSystemSID()
/*
Routine Description:
Load service account as SID string.
Parameter:
None.
Returns:
S_OK or error code
--*/
{
DWORD dwStatus;
BOOL bSuccess = TRUE;
LPTSTR pszTextualSid = NULL;
DWORD dwTextualSid = 0;
dwStatus = CreateSystemSid( &g_pSidSystem );
if( ERROR_SUCCESS == dwStatus )
{
// convert SID to string
bSuccess = GetTextualSid(
g_pSidSystem,
NULL,
&dwTextualSid
);
if( FALSE == bSuccess && ERROR_INSUFFICIENT_BUFFER == GetLastError() )
{
pszTextualSid = (LPTSTR)LocalAlloc(
LPTR,
(dwTextualSid + 1) * sizeof(TCHAR)
);
if( NULL != pszTextualSid )
{
bSuccess = GetTextualSid(
g_pSidSystem,
pszTextualSid,
&dwTextualSid
);
if( TRUE == bSuccess )
{
g_LocalSystemSID = pszTextualSid;
}
}
}
if( 0 == g_LocalSystemSID.Length() )
{
dwStatus = GetLastError();
}
}
if( NULL != pszTextualSid )
{
LocalFree(pszTextualSid);
}
return HRESULT_FROM_WIN32(dwStatus);
}
HRESULT
CRemoteDesktopHelpSessionMgr::LogSalemEvent(
IN long ulEventType,
IN long ulEventCode,
IN long numStrings,
IN LPCTSTR* pszStrings
)
/*++
Description:
Log a Salem related event, this is invoked by TermSrv and rdshost to log
event related to help assistant connection.
Parameters:
Returns:
S_OK or error code.
--*/
{
HRESULT hRes = S_OK;
switch( ulEventCode )
{
case REMOTEASSISTANCE_EVENTLOG_TERMSRV_INVALID_TICKET:
if( numStrings >= 3 )
{
// this event require three parameters.
ulEventCode = SESSMGR_E_REMOTEASSISTANCE_CONNECTFAILED;
_Module.LogEventString(
ulEventType,
ulEventCode,
numStrings,
pszStrings
);
}
else
{
hRes = HRESULT_FROM_WIN32( ERROR_INVALID_PARAMETER );
}
break;
case REMOTEASSISTANCE_EVENTLOG_TERMSRV_REVERSE_CONNECT:
// need at least three parameters.
if( numStrings >= 3 )
{
//
// String is in the order of
// expert IP address from client
// expert IP address from rdshost.exe
// Ticket ID.
//
LPCTSTR pszLogStrings[4];
ulEventCode = SESSMGR_I_REMOTEASSISTANCE_CONNECTTOEXPERT;
RemoteDesktopHelpSessionObj* pObj;
//
// Load expire help session in order to log event, we will let
// validation catch error
//
pObj = LoadHelpSessionObj( NULL, CComBSTR(pszStrings[2]), TRUE );
if( NULL != pObj )
{
pszLogStrings[0] = (LPCTSTR)pObj->m_EventLogInfo.bstrNoviceDomain;
pszLogStrings[1] = (LPCTSTR)pObj->m_EventLogInfo.bstrNoviceAccount;
pszLogStrings[2] = pszStrings[0];
pszLogStrings[3] = pszStrings[1];
_Module.LogEventString(
ulEventType,
ulEventCode,
4,
pszLogStrings
);
pObj->Release();
}
else
{
hRes = HRESULT_FROM_WIN32( ERROR_FILE_NOT_FOUND );
}
}
else
{
hRes = HRESULT_FROM_WIN32( ERROR_INVALID_PARAMETER );
MYASSERT(FALSE);
}
break;
default:
MYASSERT(FALSE);
hRes = HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER);
}
return hRes;
}
STDMETHODIMP
CRemoteDesktopHelpSessionMgr::LogSalemEvent(
/*[in]*/ long ulEventType,
/*[in]*/ long ulEventCode,
/*[in]*/ VARIANT* pEventStrings
)
/*++
--*/
{
HRESULT hRes = S_OK;
BSTR* bstrArray = NULL;
SAFEARRAY* psa = NULL;
VARTYPE vt_type;
DWORD dwNumStrings = 0;
hRes = ImpersonateClient();
if( FAILED(hRes) )
{
goto CLEANUPANDEXIT;
}
//
// Make sure only system service can invoke this call.
//
if( !g_pSidSystem || FALSE == IsCallerSystem(g_pSidSystem) )
{
#if DISABLESECURITYCHECKS
DWORD dump;
BOOL bStatus;
//
// For testing only, allow admin to invoke this call
//
dump = IsUserAdmin(&bStatus);
hRes = HRESULT_FROM_WIN32( dump );
if( FAILED(hRes) || FALSE == bStatus )
{
EndImpersonateClient();
hRes = HRESULT_FROM_WIN32( ERROR_ACCESS_DENIED );
goto CLEANUPANDEXIT;
}
#else
EndImpersonateClient();
hRes = HRESULT_FROM_WIN32( ERROR_ACCESS_DENIED );
goto CLEANUPANDEXIT;
#endif
}
// No need to run as client.
EndImpersonateClient();
if( NULL == pEventStrings )
{
hRes = LogSalemEvent( ulEventType, ulEventCode );
}
else
{
//
// we only support BSTR data type.
if( !(pEventStrings->vt & VT_BSTR) )
{
MYASSERT(FALSE);
hRes = E_INVALIDARG;
goto CLEANUPANDEXIT;
}
//
// we are dealing with multiple BSTRs
if( pEventStrings->vt & VT_ARRAY )
{
psa = pEventStrings->parray;
// only accept 1 dim.
if( 1 != SafeArrayGetDim(psa) )
{
hRes = E_INVALIDARG;
MYASSERT(FALSE);
goto CLEANUPANDEXIT;
}
// only accept BSTR as input type.
hRes = SafeArrayGetVartype( psa, &vt_type );
if( FAILED(hRes) )
{
MYASSERT(FALSE);
goto CLEANUPANDEXIT;
}
if( VT_BSTR != vt_type )
{
DebugPrintf(
_TEXT("Unsupported type 0x%08x\n"),
vt_type
);
hRes = E_INVALIDARG;
MYASSERT(FALSE);
goto CLEANUPANDEXIT;
}
hRes = SafeArrayAccessData(psa, (void **)&bstrArray);
if( FAILED(hRes) )
{
MYASSERT(FALSE);
goto CLEANUPANDEXIT;
}
hRes = LogSalemEvent(
ulEventType,
ulEventCode,
psa->rgsabound->cElements,
(LPCTSTR *)bstrArray
);
SafeArrayUnaccessData(psa);
}
else
{
hRes = LogSalemEvent(
ulEventType,
ulEventCode,
1,
(LPCTSTR *)&(pEventStrings->bstrVal)
);
}
}
CLEANUPANDEXIT:
return hRes;
}
void
CRemoteDesktopHelpSessionMgr::NotifyExpertLogoff(
LONG ExpertSessionId,
BSTR HelpedTicketId
)
/*++
Routine Description:
Notify help ticket that helping expert has logoff so
ticket object can de-associate (mark is not been help) with a
particular helper session.
Parameters:
ExpertSessionId : Expert logon session ID.
HelpedTicketId : Ticket ID that expert was providing help.
Returns:
None.
--*/
{
MYASSERT( NULL != HelpedTicketId );
if( NULL != HelpedTicketId )
{
DebugPrintf(
_TEXT("NotifyExpertLogoff() on %d %s...\n"),
ExpertSessionId,
HelpedTicketId
);
//
// Load Help Entry, we need to inform resolver on disconnect so load
// expired ticket.
//
RemoteDesktopHelpSessionObj* pObj = LoadHelpSessionObj( NULL, HelpedTicketId, TRUE );
if( NULL != pObj )
{
MYASSERT( ExpertSessionId == pObj->GetHelperSessionId() );
if( ExpertSessionId == pObj->GetHelperSessionId() )
{
pObj->NotifyDisconnect();
}
pObj->Release();
}
//
// Free ticket ID
//
SysFreeString( HelpedTicketId );
}
return;
}