windows-nt/Source/XPSP1/NT/net/config/netcfg/engine/modify.cpp
2020-09-26 16:20:57 +08:00

1749 lines
54 KiB
C++

//+---------------------------------------------------------------------------
//
// Microsoft Windows
// Copyright (C) Microsoft Corporation, 1999.
//
// File: M O D I F Y . C P P
//
// Contents: Routines used to setup modifications to the network
// configuration.
//
// Notes:
//
// Author: shaunco 15 Jan 1999
//
//----------------------------------------------------------------------------
#include <pch.h>
#pragma hdrstop
#include "classinst.h"
#include "filtdevs.h"
#include "guisetup.h"
#include "inetcfg.h"
#include "lockdown.h"
#include "ncmsz.h"
#include "ncreg.h"
#include "ncsvc.h"
#include "ndispnp.h"
#include "netcfg.h"
#include "persist.h"
#include "pnpbind.h"
#include "pszarray.h"
#include "util.h"
#include "wscfg.h"
#include "ncwins.h"
#include "ncperms.h"
CNetConfig*
CModifyContext::PNetConfig ()
{
TraceFileFunc(ttidNetcfgBase);
CNetConfig* pNetConfig;
Assert ((LONG_PTR)this > FIELD_OFFSET(CNetConfig, ModifyCtx));
// Get our containing CNetConfig pointer.
//
pNetConfig = CONTAINING_RECORD(this, CNetConfig, ModifyCtx);
pNetConfig->Core.DbgVerifyData ();
return pNetConfig;
}
HRESULT
CModifyContext::HrDirtyComponent (
IN const CComponent* pComponent)
{
TraceFileFunc(ttidNetcfgBase);
Assert (S_OK == m_hr);
Assert (m_fPrepared);
Assert (pComponent);
m_hr = m_DirtyComponents.HrInsertComponent (pComponent,
INS_IGNORE_IF_DUP | INS_SORTED);
#if DBG
m_fComponentExplicitlyDirtied = TRUE;
#endif
TraceHr (ttidError, FAL, m_hr, FALSE,
"CModifyContext::HrDirtyComponentAndComponentsAbove");
return m_hr;
}
HRESULT
CModifyContext::HrDirtyComponentAndComponentsAbove (
IN const CComponent* pComponent)
{
TraceFileFunc(ttidNetcfgBase);
GCCONTEXT Ctx;
Assert (S_OK == m_hr);
Assert (m_fPrepared);
Assert (pComponent);
// And insert the component itself.
//
m_hr = HrDirtyComponent (pComponent);
// Only dirty the ones above if this component doesn't have the
// NCF_DONTEXPOSELOWER characteristic.
//
if ((S_OK == m_hr) && !(pComponent->m_dwCharacter & NCF_DONTEXPOSELOWER))
{
// Initialize the members of our context structure for recursion.
//
ZeroMemory (&Ctx, sizeof(Ctx));
Ctx.pStackTable = &(PNetConfig()->Core.StackTable);
Ctx.pComponents = &m_DirtyComponents;
// Insert all of the component above.
//
GetComponentsAboveComponent (pComponent, &Ctx);
m_hr = Ctx.hr;
}
TraceHr (ttidError, FAL, m_hr, FALSE,
"CModifyContext::HrDirtyComponentAndComponentsAbove");
return m_hr;
}
HRESULT
CModifyContext::HrApplyIfOkOrCancel (
IN BOOL fApply)
{
TraceFileFunc(ttidNetcfgBase);
HRESULT hr;
CNetConfig* pNetConfig;
Assert (m_fPrepared);
pNetConfig = PNetConfig();
// Only apply if the context result is S_OK.
//
if (fApply && (S_OK == m_hr))
{
// Setupapi calls that we make during ApplyChanges have the
// potential to return control to our clients windows message loop.
// When this happens, and our clients are poorly written, they
// may try to re-enter us on the same thread. This is disaster
// waiting to happen, so we need to prevent it by raising our
// reentrancy protection level before we start apply changes.
//
pNetConfig->Notify.PINetCfg()->RaiseRpl (RPL_DISALLOW);
ApplyChanges ();
pNetConfig->Notify.PINetCfg()->LowerRpl (RPL_DISALLOW);
// Delete those components from m_CoreStartedWith that are not
// in the current core and reset the modify context.
//
m_CoreStartedWith.Components.FreeComponentsNotInOtherComponentList (
&pNetConfig->Core.Components);
m_CoreStartedWith.Clear();
hr = S_OK;
// Return the correct HRESULT to the caller. If we've successfully
// applied, but need a reboot, return so.
//
if (m_fRebootRecommended || m_fRebootRequired)
{
hr = NETCFG_S_REBOOT;
}
}
else
{
// Cancel and release all notify objects. Do this for what is
// in the core as well as what we started with. (There will
// be some overlap, but they will only be released once.)
// We need to do both sets so we don't miss releasing components
// that have been removed. (Removed components won't be in
// current core, but they will be in the core that we started
// with.) Likewise, if we just released the core we started with,
// we'd miss releasing those components that were added.)
//
pNetConfig->Notify.ReleaseAllNotifyObjects (pNetConfig->Core.Components, TRUE);
pNetConfig->Notify.ReleaseAllNotifyObjects (m_CoreStartedWith.Components, TRUE);
// Delete those components from m_CoreStartedWith that are not
// in the current core. Then delete all the components in the
// current core and reload from our persistent storage.
// (This has the nice effect of invalidating all outstanding
// INetCfgComponent interfaces.)
//
m_CoreStartedWith.Components.FreeComponentsNotInOtherComponentList (
&pNetConfig->Core.Components);
pNetConfig->Core.Free ();
// Eject both cores (didn't you just know this metaphor was coming ;-)
// and reload the core from our persisted binary. This magically,
// and completely rolls everything back.
//
m_CoreStartedWith.Clear();
pNetConfig->Core.Clear();
// Return reason for failure through hr.
//
hr = m_hr;
// Reload the configuration and, if successful, it means m_hr
// will be S_OK. If unsuccessful, m_hr will be the error and will
// prevent subsequent operations.
//
m_hr = HrLoadNetworkConfigurationFromRegistry (KEY_READ, pNetConfig);
}
// Very important to set m_fPrepared back to FALSE so that HrPrepare gets
// called for the next modifcation and correctly copy the core etc.
//
m_fPrepared = FALSE;
m_AddedBindPaths.Clear();
m_DeletedBindPaths.Clear();
m_DirtyComponents.Clear();
#if DBG
m_fComponentExplicitlyDirtied = FALSE;
#endif
Assert (!m_fPrepared);
Assert (m_CoreStartedWith.FIsEmpty());
Assert (m_AddedBindPaths.FIsEmpty());
Assert (m_DeletedBindPaths.FIsEmpty());
Assert (m_DirtyComponents.FIsEmpty());
Assert (0 == m_ulRecursionDepth);
Assert (!m_fComponentExplicitlyDirtied);
Assert ((S_OK == hr) || (NETCFG_S_REBOOT == hr) || FAILED(hr));
TraceHr (ttidError, FAL, hr, NETCFG_S_REBOOT == hr,
"CModifyContext::HrApplyIfOkOrCancel");
return hr;
}
HRESULT
CModifyContext::HrPrepare ()
{
TraceFileFunc(ttidNetcfgBase);
Assert (S_OK == m_hr);
Assert (!m_fPrepared);
Assert (m_CoreStartedWith.FIsEmpty());
Assert (m_AddedBindPaths.FIsEmpty());
Assert (m_DeletedBindPaths.FIsEmpty());
Assert (m_DirtyComponents.FIsEmpty());
Assert (0 == m_ulRecursionDepth);
Assert (!m_fComponentExplicitlyDirtied);
CNetConfig* pThis;
pThis = PNetConfig();
// Prepare the bind context. This will ensure all of the external
// data for all components is loaded as well as all ensuring that
// all notify objects have been initialized.
//
m_hr = m_RegBindCtx.HrPrepare (pThis);
if (S_OK != m_hr)
{
goto finished;
}
// Snapshot the current core so that we know what we started with.
// We will use the differences when we apply (if we get that far).
//
m_hr = m_CoreStartedWith.HrCopyCore (&pThis->Core);
if (S_OK != m_hr)
{
goto finished;
}
// Reserve room for 64 components in the core.
// (64 * 4 = 256 bytes on 32-bit platforms)
//
m_hr = pThis->Core.Components.HrReserveRoomForComponents (64);
if (S_OK != m_hr)
{
goto finished;
}
// Reserve room for 64 stack entries in the core.
// (64 * (4 + 4) = 512 bytes on 32-bit platforms)
//
m_hr = pThis->Core.StackTable.HrReserveRoomForEntries (64);
if (S_OK != m_hr)
{
goto finished;
}
// Reserve room in our added list for 64 bindpaths of 8 components.
// (64 * 16 = 1K bytes on 32-bit platforms)
//
m_hr = m_AddedBindPaths.HrReserveRoomForBindPaths (64);
if (S_OK != m_hr)
{
goto finished;
}
// Reserve room in our deleted list for 64 bindpaths of 8 components.
// (64 * 16 = 1K bytes on 32-bit platforms)
//
m_hr = m_DeletedBindPaths.HrReserveRoomForBindPaths (64);
if (S_OK != m_hr)
{
goto finished;
}
// Reserve room for 64 components in the dirty component list.
// (64 * 4) = 256 bytes on 32-bit platforms)
//
m_hr = m_DirtyComponents.HrReserveRoomForComponents (64);
if (S_OK != m_hr)
{
goto finished;
}
m_fPrepared = TRUE;
finished:
TraceHr (ttidError, FAL, m_hr, FALSE, "CModifyContext::HrPrepare");
return m_hr;
}
HRESULT
CModifyContext::HrBeginBatchOperation ()
{
TraceFileFunc(ttidNetcfgBase);
Assert (S_OK == m_hr);
Assert (m_fPrepared);
Assert (0 == m_ulRecursionDepth);
TraceTag (ttidBeDiag, "Begin batch operation...");
PushRecursionDepth();
return m_hr;
}
HRESULT
CModifyContext::HrEndBatchOperation (
IN EBO_FLAG Flag)
{
TraceFileFunc(ttidNetcfgBase);
HRESULT hr;
Assert (m_fPrepared);
Assert (1 == m_ulRecursionDepth);
if (EBO_COMMIT_NOW == Flag)
{
TraceTag (ttidBeDiag, "End batch (commiting changes)...");
hr = HrPopRecursionDepth ();
}
else
{
Assert (EBO_DEFER_COMMIT_UNTIL_APPLY == Flag);
TraceTag (ttidBeDiag, "End batch (deferring commit until Apply)...");
m_ulRecursionDepth = 0;
hr = S_OK;
}
Assert (0 == m_ulRecursionDepth);
TraceHr (ttidError, FAL, hr, FALSE,
"CModifyContext::HrEndBatchOperation");
return hr;
}
VOID
CModifyContext::PushRecursionDepth ()
{
TraceFileFunc(ttidNetcfgBase);
Assert (S_OK == m_hr);
Assert (m_fPrepared);
m_ulRecursionDepth++;
}
HRESULT
CModifyContext::HrPopRecursionDepth ()
{
TraceFileFunc(ttidNetcfgBase);
Assert (m_fPrepared);
Assert (m_ulRecursionDepth > 0);
m_ulRecursionDepth--;
if (0 != m_ulRecursionDepth)
{
return m_hr;
}
// We're at the top-level of the install or remove modifcation so
// apply or cancel the changes depending on the state of the context
// result.
//
HRESULT hr;
hr = HrApplyIfOkOrCancel (S_OK == m_hr);
TraceHr (ttidError, FAL, hr, FALSE,
"CModifyContext::HrPopRecursionDepth");
return hr;
}
//----------------------------------------------------------------------------
// This is a convenience method to find and process Winsock Remove
// section for a component which is about to be removed.
HRESULT
CModifyContext::HrProcessWinsockRemove(IN const CComponent *pComponent)
{
TraceFileFunc(ttidNetcfgBase);
HINF hinf = NULL;
HKEY hkeyInstance = NULL;
HRESULT hr;
Assert(pComponent);
hr = pComponent->HrOpenInfFile(&hinf);
if (S_OK == hr)
{
static const WCHAR c_szRemoveSectionSuffix[] = L".Remove";
// We get the remove section name and process all relevant sections
WCHAR szRemoveSection[_MAX_PATH];
DWORD cbBuffer = sizeof (szRemoveSection);
hr = pComponent->HrOpenInstanceKey (KEY_READ,
&hkeyInstance, NULL, NULL);
if(S_OK == hr)
{
hr = HrRegQuerySzBuffer (hkeyInstance, REGSTR_VAL_INFSECTION,
szRemoveSection, &cbBuffer);
if (S_OK == hr)
{
//HrAddOrRemoveWinsockDependancy processes the winsock
//remove section in the given inf file and then calls
//MigrateWinsockConfiguration which will cause the
//necessary PnP notifications to be issued to the
//interested application.
wcscat (szRemoveSection, c_szRemoveSectionSuffix);
hr = HrAddOrRemoveWinsockDependancy (hinf, szRemoveSection);
}
RegSafeCloseKey (hkeyInstance);
}
}
TraceHr (ttidError, FAL, hr, FALSE,
"CModifyContext::HrProcessWinsockRemove (%S)",
pComponent->PszGetPnpIdOrInfId());
return hr;
}
VOID
CModifyContext::ApplyChanges ()
{
TraceFileFunc(ttidNetcfgBase);
HRESULT hr;
CNetConfig* pNetConfig;
CComponentList::const_iterator iter;
CComponent* pComponent;
CFilterDevices FilterDevices (&PNetConfig()->Core);
CPszArray ServiceNames;
CServiceManager ServiceManager;
PCWSTR pszService;
BOOL fRebootNeeded;
BOOL fMigrateWinsock;
BOOL fModifyFilterDevices;
BOOL fSignalNetworkProviderLoaded;
BOOL fUserIsNetConfigOps;
BOOL fCallCoFreeUnusedLibraries;
Assert (S_OK == m_hr);
Assert (m_fPrepared);
Assert (0 == m_ulRecursionDepth);
pNetConfig = PNetConfig();
fMigrateWinsock = FALSE;
fModifyFilterDevices = FALSE;
fSignalNetworkProviderLoaded = FALSE;
fUserIsNetConfigOps = FIsUserNetworkConfigOps();
fCallCoFreeUnusedLibraries = FALSE;
//+-----------------------------------------------------------------------
// Step 0: Prepare m_AddedBindPaths, m_DeletedBindPaths, and
// m_DirtyComponents.
//
// Add the bindpaths that were once disabled, but are now enabled, to
// m_AddedBindPaths. We do this so that PnP notifications are sent for
// them.
//
m_hr = m_AddedBindPaths.HrAddBindPathsInSet1ButNotInSet2 (
&m_CoreStartedWith.DisabledBindings,
&pNetConfig->Core.DisabledBindings);
if (S_OK != m_hr)
{
return;
}
// Add the bindpaths that were once enabled, but are now disabled, to
// m_DeletedBindPaths. We do this so that PnP notifications are sent for
// them.
//
m_hr = m_DeletedBindPaths.HrAddBindPathsInSet1ButNotInSet2 (
&pNetConfig->Core.DisabledBindings,
&m_CoreStartedWith.DisabledBindings);
if (S_OK != m_hr)
{
return;
}
// m_fDirtyComponents should be empty unless we've explicitly dirtied
// one or more. If m_fDirtyComponents were not empty, it would probably
// mean we forgot to clear it after the last Apply or Cancel.
// Conversely, m_DirtyComponents better not be empty if we've explicitly
// dirtied one or more.
//
Assert (FIff(!m_fComponentExplicitlyDirtied, m_DirtyComponents.FIsEmpty()));
// Dirty the affected components (owners and adapters in bindpaths of
// length 2) from the added and deleted bindpaths. We need to write
// bindings for these components.
//
m_hr = m_AddedBindPaths.HrGetAffectedComponentsInBindingSet (
&m_DirtyComponents);
if (S_OK != m_hr)
{
return;
}
m_hr = m_DeletedBindPaths.HrGetAffectedComponentsInBindingSet (
&m_DirtyComponents);
if (S_OK != m_hr)
{
return;
}
// Dirty components that exist in the current core, but not in the core
// we started with. (These are added components).
//
m_hr = m_DirtyComponents.HrAddComponentsInList1ButNotInList2 (
&pNetConfig->Core.Components,
&m_CoreStartedWith.Components);
if (S_OK != m_hr)
{
return;
}
// Dirty components that exist in the core we started with, but not in
// the current core. (These are removed components).
//
m_hr = m_DirtyComponents.HrAddComponentsInList1ButNotInList2 (
&m_CoreStartedWith.Components,
&pNetConfig->Core.Components);
if (S_OK != m_hr)
{
return;
}
g_pDiagCtx->Printf (ttidBeDiag,
"Step 0: The following components are dirty:\n");
for (iter = m_DirtyComponents.begin();
iter != m_DirtyComponents.end();
iter++)
{
pComponent = *iter;
Assert (pComponent);
if (!pNetConfig->Core.Components.FComponentInList (pComponent))
{
g_pDiagCtx->Printf (ttidBeDiag, " %-12S (removed)\n",
pComponent->PszGetPnpIdOrInfId());
}
else if (!m_CoreStartedWith.Components.FComponentInList (pComponent))
{
g_pDiagCtx->Printf (ttidBeDiag, " %-12S (installed)\n",
pComponent->PszGetPnpIdOrInfId());
}
else
{
g_pDiagCtx->Printf (ttidBeDiag, " %S\n",
pComponent->PszGetPnpIdOrInfId());
}
}
// Reserve room for 32 pointers to service names. We use this buffer
// to start and stop services.
//
m_hr = ServiceNames.HrReserveRoomForPointers (32);
if (S_OK != m_hr)
{
return;
}
// See if we are going to modify any filter devices. If we are,
// we'll go through all of the steps of loading filter devices, removing
// any we don't need, installing any new ones, and binding them all up.
// We only modify filter devices if the user is a normal admin and not
// a netcfgop.
//
// This test could be further refined to see if we had any filters which
// were dirty or if we had any dirty adapters which are filtered.
//
if (!fUserIsNetConfigOps)
{
fModifyFilterDevices = pNetConfig->Core.FContainsFilterComponent() ||
m_CoreStartedWith.FContainsFilterComponent();
}
else
{
Assert(!fModifyFilterDevices);
}
if (fModifyFilterDevices)
{
// Allow the filter devices structure to reserve whatever memory it
// may need.
//
m_hr = FilterDevices.HrPrepare ();
if (S_OK != m_hr)
{
return;
}
}
pNetConfig->Core.DisabledBindings.Printf (ttidBeDiag,
" The following bindings are currently disabled:\n");
//+-----------------------------------------------------------------------
// Step 1: Save the network configuration binary.
//
g_pDiagCtx->Printf (ttidBeDiag,
"Step 1: Save the network configuration binary.\n");
HrSaveNetworkConfigurationToRegistry (pNetConfig);
//+-----------------------------------------------------------------------
// Step 2: Write the static bindings for all changed components.
//
g_pDiagCtx->Printf (ttidBeDiag,
"Step 2: Write the following static bindings.\n");
for (iter = m_DirtyComponents.begin();
iter != m_DirtyComponents.end();
iter++)
{
pComponent = *iter;
Assert (pComponent);
// If any protocols are dirty, we'll want to migrate winsock
// configuration later.
//
if (NC_NETTRANS == pComponent->Class())
{
fMigrateWinsock = TRUE;
}
// If the component is in the core, write its bindings.
// If it is not in the core, it means it has been removed and
// we should therefore remove its bindings.
//
if (pNetConfig->Core.Components.FComponentInList (pComponent))
{
hr = m_RegBindCtx.HrWriteBindingsForComponent (pComponent);
// Remember any errors, but continue.
//
if (S_OK != hr)
{
Assert (FAILED(hr));
m_hr = hr;
}
}
else
{
// Only delete if we're not installing another version of this
// component that has a duplicate PnpId. If we had already
// written the bindings for the newly installed one, and then
// deleted the ones for the removed (yet duplicate PnpId), we'd
// effectivly delete the bindings for the new one too. See the
// comments at step 6 for how we can get into this case.
//
if (!FIsEnumerated (pComponent->Class()) ||
!pNetConfig->Core.Components.PFindComponentByPnpId (
pComponent->m_pszPnpId))
{
// There's no reason to fail if we can't delete the bindings.
// The entire component is about to be tossed anyway.
//
(VOID) m_RegBindCtx.HrDeleteBindingsForComponent (pComponent);
}
}
}
//+-----------------------------------------------------------------------
// Step 3: Notify ApplyRegistryChanges
//
g_pDiagCtx->Printf (ttidBeDiag,
"Step 3: Notify: apply registry changes\n");
for (iter = m_DirtyComponents.begin();
iter != m_DirtyComponents.end();
iter++)
{
pComponent = *iter;
Assert (pComponent);
pComponent->Notify.ApplyRegistryChanges (
pNetConfig->Notify.PINetCfg(),
&fRebootNeeded);
if (fRebootNeeded)
{
m_fRebootRecommended = TRUE;
g_pDiagCtx->Printf (ttidBeDiag, " %S notify object wants a reboot\n",
pComponent->m_pszInfId);
}
}
// Migrate Winsock configuration if needed.
// Important to do this after the LANA map is written, afer Notify Applys
// are called, but before any services are started.
//
if (fMigrateWinsock)
{
g_pDiagCtx->Printf (ttidBeDiag, "Migrating winsock configuration.\n");
(VOID) HrMigrateWinsockConfiguration ();
}
//+-----------------------------------------------------------------------
// Step 4: Unbind deleted bindpaths.
//
g_pDiagCtx->Printf (ttidBeDiag,
"Step 4: Unbind the following deleted bindings:\n");
if (!m_DeletedBindPaths.FIsEmpty())
{
// We don't need to send UNBIND notifications for bindpaths that
// involve adapters that have been removed. They will be unbound
// automatically when the adapter is uninstalled. (For the case
// when the class installer is notifying us of a removed adapter,
// its important NOT to try to send an UNBIND notification because
// the adapter has already been uninstalled (hence unbound) and
// our notification might come back in error causing us to need
// a reboot uneccessary.
//
// So, remove the bindpaths in m_DeletedBindPaths that involve
// adapters that have been removed.
//
for (iter = m_DirtyComponents.begin();
iter != m_DirtyComponents.end();
iter++)
{
pComponent = *iter;
Assert (pComponent);
// If its enumerated, and not in the current core, its a
// removed adapter.
//
if (FIsEnumerated (pComponent->Class()) &&
!pNetConfig->Core.Components.FComponentInList (pComponent))
{
m_DeletedBindPaths.RemoveBindPathsWithComponent (pComponent);
}
}
m_DeletedBindPaths.SortForPnpUnbind ();
m_RegBindCtx.PnpBindOrUnbindBindPaths (UNBIND,
&m_DeletedBindPaths,
&fRebootNeeded);
if (fRebootNeeded)
{
m_fRebootRecommended = TRUE;
}
}
//+-----------------------------------------------------------------------
// Step 5: Stop services for removed components.
//
g_pDiagCtx->Printf (ttidBeDiag,
"Step 5: Stop the following services:\n");
Assert (0 == ServiceNames.Count());
for (iter = m_DirtyComponents.begin();
iter != m_DirtyComponents.end();
iter++)
{
pComponent = *iter;
Assert (pComponent);
// Ignore enumerated components because they will have their drivers
// stopped automatically (if appropriate) when they are removed.
// Ignore components that are in the current core (not being removed).
//
if (FIsEnumerated (pComponent->Class()) ||
pNetConfig->Core.Components.FComponentInList (pComponent))
{
continue;
}
// Winsock remove section needs to be processed for every
// component that is being removed in order to update
// Transport key for the winsock registry settings
HrProcessWinsockRemove (pComponent);
// If its a protcol, send an UNLOAD before trying to stop the service.
//
if ((NC_NETTRANS == pComponent->Class()) || (NCF_NDIS_PROTOCOL & pComponent->m_dwCharacter))
{
// Unload can fail as a lot of drivers do not support it.
// Treat it as an 'FYI' indication and don't set the reboot
// flag if it fails.
//
(VOID) HrPnpUnloadDriver (NDIS, pComponent->Ext.PszBindName());
}
// Ignore components that don't have any services.
if (!pComponent->Ext.PszCoServices())
{
continue;
}
for (pszService = pComponent->Ext.PszCoServices();
*pszService;
pszService += wcslen(pszService) + 1)
{
(VOID)ServiceNames.HrAddPointer (pszService);
g_pDiagCtx->Printf (ttidBeDiag, " %S", pszService);
}
g_pDiagCtx->Printf (ttidBeDiag, "\n");
}
if (ServiceNames.Count() > 0)
{
static const CSFLAGS CsStopFlags =
{
FALSE, // FALSE means don't start
SERVICE_CONTROL_STOP, // use this control instead
15000, // wait up to 15 seconds...
SERVICE_STOPPED, // ... for service to reach this state
FALSE, //
};
hr = ServiceManager.HrControlServicesAndWait (
ServiceNames.Count(),
ServiceNames.begin(),
&CsStopFlags);
if (S_OK != hr)
{
m_fRebootRequired = TRUE;
g_pDiagCtx->Printf (ttidBeDiag, " some service failed to stop (hr = 0x%08X)\n",
hr);
// Unfortunately, there is no easy way to get back which service
// did not stop and then to figure out which component contains
// that service. Sooo, we'll just put every component that is
// being removed in lockdown. This isn't a big deal when the UI
// is doing the removal because it only removes things one at a
// time.
//
for (iter = m_DirtyComponents.begin();
iter != m_DirtyComponents.end();
iter++)
{
pComponent = *iter;
Assert (pComponent);
if (FIsEnumerated (pComponent->Class()) ||
!pComponent->Ext.PszCoServices() ||
pNetConfig->Core.Components.FComponentInList (pComponent))
{
continue;
}
LockdownComponentUntilNextReboot (pComponent->m_pszInfId);
}
}
ServiceNames.Clear();
}
//+-----------------------------------------------------------------------
// Step 5a: Uninstall filters first.
//
if (fModifyFilterDevices)
{
g_pDiagCtx->Printf(ttidBeDiag, "Step 5a: Remove filter devices:\n");
// Order is of utmost importance here. Remove must be called first
// because it initializes some state internal to FilterDevices. Start
// must come after Write and Write obviously has to come after all
// new filter devices are installed.
//
FilterDevices.LoadAndRemoveFilterDevicesIfNeeded ();
}
//+-----------------------------------------------------------------------
// Step 6: Uninstall removed components.
//
g_pDiagCtx->Printf (ttidBeDiag,
"Step 6: Uninstall the following components:\n");
for (iter = m_DirtyComponents.begin();
iter != m_DirtyComponents.end();
iter++)
{
pComponent = *iter;
Assert (pComponent);
// If the component is in the core, ignore it.
// If it is not in the core, it means it has been removed and
// we should therefore remove its bindings.
//
if (pNetConfig->Core.Components.FComponentInList (pComponent))
{
continue;
}
// If this is an enumerated component whose PnpId matches that of
// a component in the current core, we've run into a special case.
// This can happen when the external data (like the NetCfgInstanceId)
// is corrupted and the class installer was told to update the
// component. The class installer is really told to "install" the
// component, but if it already exists as determined by the presence
// of NetCfgInstanceId, the class installer translates it to "update".
// Without the key, the class installer thinks its installing
// a new one. We detect the duplicate PnpId and remove the "prior"
// so we can install the "new". This "prior" instance is what we
// are finalizing the remove of, but if we call HrCiRemoveComponent,
// it just removes the same PnpId that the class installer told us
// to install. By not calling HrCiRemoveComponent for this case,
// the "prior" instance key gets reused implicitly by the "new"
// instance.
//
if (FIsEnumerated (pComponent->Class()) &&
pNetConfig->Core.Components.PFindComponentByPnpId (
pComponent->m_pszPnpId))
{
g_pDiagCtx->Printf (ttidBeDiag,
" Skip removal of %S because a duplicate was installed\n",
pComponent->m_pszPnpId);
continue;
}
g_pDiagCtx->Printf (ttidBeDiag,
" %S\n", pComponent->PszGetPnpIdOrInfId());
hr = HrCiRemoveComponent (pComponent, &pComponent->m_strRemoveSection);
// We can ignore SPAPI_E_NO_SUCH_DEVINST because the class installer
// may have already removed it and is just notifying us.
//
if ((S_OK != hr) && (SPAPI_E_NO_SUCH_DEVINST != hr))
{
m_fRebootRequired = TRUE;
g_pDiagCtx->Printf (ttidBeDiag, " ^^^ needs a reboot (hr = 0x%08X)\n",
hr);
}
}
//+-----------------------------------------------------------------------
// Step 6a: Modify filter devices.
//
if (fModifyFilterDevices)
{
g_pDiagCtx->Printf (ttidBeDiag, "Step 6a: Modify filter devices:\n");
FilterDevices.InstallFilterDevicesIfNeeded ();
(VOID)m_RegBindCtx.HrWriteBindingsForFilterDevices (&FilterDevices);
PruneNdisWanBindPathsIfActiveRasConnections (
&FilterDevices.m_BindPathsToRebind,
&fRebootNeeded);
if (fRebootNeeded)
{
m_fRebootRecommended = TRUE;
}
m_RegBindCtx.PnpBindOrUnbindBindPaths (UNBIND,
&FilterDevices.m_BindPathsToRebind,
&fRebootNeeded);
if (fRebootNeeded)
{
m_fRebootRecommended = TRUE;
}
g_pDiagCtx->Printf (ttidBeDiag, "Step 6b: Starting filter devices:\n");
FilterDevices.StartFilterDevices ();
FilterDevices.Free ();
}
//+-----------------------------------------------------------------------
// Step 7: Start services for added components.
//
Assert (0 == ServiceNames.Count());
g_pDiagCtx->Printf (ttidBeDiag,
"Step 7: Start the following drivers/services:\n");
for (iter = m_DirtyComponents.begin();
iter != m_DirtyComponents.end();
iter++)
{
pComponent = *iter;
Assert (pComponent);
// If the component is in the core we started with, ignore it.
// If it is not in the core we started with, it means it is newly
// installed we should therefore start its services.
//
if (m_CoreStartedWith.Components.FComponentInList (pComponent))
{
continue;
}
// If we've added a network client, we'll need to signal the
// network provider loaded event after we've started its service.
//
if (NC_NETCLIENT == pComponent->Class())
{
fSignalNetworkProviderLoaded = TRUE;
}
if (FIsEnumerated (pComponent->Class()))
{
g_pDiagCtx->Printf (ttidBeDiag, " %S\n", pComponent->m_pszPnpId);
hr = pComponent->HrStartOrStopEnumeratedComponent (DICS_START);
if (S_OK != hr)
{
m_fRebootRecommended = TRUE;
g_pDiagCtx->Printf (ttidBeDiag, " ^^^ needs a reboot (hr = 0x%08X)\n",
hr);
}
if (FIsPhysicalNetAdapter (pComponent->Class(),
pComponent->m_dwCharacter) && FInSystemSetup())
{
ProcessAdapterAnswerFileIfExists (pComponent);
}
}
else if (pComponent->Ext.PszCoServices())
{
for (pszService = pComponent->Ext.PszCoServices();
*pszService;
pszService += wcslen(pszService) + 1)
{
(VOID)ServiceNames.HrAddPointer (pszService);
g_pDiagCtx->Printf (ttidBeDiag, " %S", pszService);
}
g_pDiagCtx->Printf (ttidBeDiag, "\n");
// If we're in system setup, then exclude whatever services
// the component has marked as such.
//
if (FInSystemSetup())
{
ExcludeMarkedServicesForSetup (pComponent, &ServiceNames);
}
}
}
if ((ServiceNames.Count() > 0) &&
!(g_pDiagCtx->Flags() & DF_DONT_START_SERVICES))
{
static const CSFLAGS CsStartFlags =
{
TRUE, // TRUE means start
0,
20000, // wait up to 20 seconds...
SERVICE_RUNNING, // ... for service to reach this state
TRUE, // ignore demand-start and disabled
};
hr = ServiceManager.HrControlServicesAndWait (
ServiceNames.Count(),
ServiceNames.begin(),
&CsStartFlags);
if (S_OK != hr)
{
m_fRebootRecommended = TRUE;
g_pDiagCtx->Printf (ttidBeDiag, " some service failed to start (hr = 0x%08X)\n",
hr);
}
}
//+-----------------------------------------------------------------------
// Step 8: Bind added bindpaths.
//
g_pDiagCtx->Printf (ttidBeDiag,
"Step 8: Bind the following added bindings:\n");
if (fModifyFilterDevices)
{
hr = m_AddedBindPaths.HrAppendBindingSet (
&FilterDevices.m_BindPathsToRebind);
if (S_OK != hr)
{
// Well, that's not good, but there is nothing we can do about
// it now. (Most likely we ran out of memory.)
}
}
if (!m_AddedBindPaths.FIsEmpty())
{
CBindPath* pBindPath;
// We don't need to send BIND notifications for bindpaths that
// involve adapters that have been newly installed. They will be
// bound automatically when the adapter is started.
//
// Update to the above comment: We THOUGHT that was correct, but it
// turns out it isn't. TDI isn't PNP (guess they must have missed
// THAT memo) and they are not re-reading the new bind strings
// from the registry when lower notifications bubble up. So, we
// have to send these BINDS for added adapters too.
//
// We should remove bindpaths that involve components that have
// been removed. These can end up in added bindpaths because way
// up in step 0, we added bindpaths that were disabled in the
// core we started with and that are no longer disabled in the
// current core. Well, when the component is removed, its disabled
// bindings are removed, so this case would have caused us to add
// the bindpath to this binding set.
//
for (iter = m_DirtyComponents.begin();
iter != m_DirtyComponents.end();
iter++)
{
pComponent = *iter;
Assert (pComponent);
// If its been removed, remove any bindpaths that reference it.
//
if (!pNetConfig->Core.Components.FComponentInList (pComponent))
{
m_AddedBindPaths.RemoveBindPathsWithComponent (pComponent);
}
}
// To prevent TDI from sending duplicate BINDs to its clients, we
// have to do a little more work. We need to not send the TDI
// BINDs to components that are newly installed. This is because
// TDI sent them the BINDs when we started the driver above.
// So, for each added bindpath, if it's going to the TDI layer, and
// the owner (topmost) component of the bindpath is newly installed,
// remove it from the added binding so we won't send a notification
// for it below.
//
pBindPath = m_AddedBindPaths.begin();
while (pBindPath != m_AddedBindPaths.end())
{
UINT unLayer = GetPnpLayerForBindPath (pBindPath);
if ((TDI == unLayer) &&
!m_CoreStartedWith.Components.FComponentInList (
pBindPath->POwner()))
{
m_AddedBindPaths.erase (pBindPath);
}
else
{
pBindPath++;
}
}
m_AddedBindPaths.SortForPnpBind ();
m_RegBindCtx.PnpBindOrUnbindBindPaths (BIND,
&m_AddedBindPaths,
&fRebootNeeded);
if (fRebootNeeded)
{
// If BINDs fail, we should recommend a reboot, but one is
// not required for subsequent installs or removes.
//
m_fRebootRecommended = TRUE;
}
}
// Signal the network provider loaded event if needed.
// Probably best to do this after we've indiciated the PnP bindings
// (above) to the new clients.
//
if (fSignalNetworkProviderLoaded)
{
SignalNetworkProviderLoaded ();
}
//+-----------------------------------------------------------------------
// Step 9: Allow notify objects to apply PnP changes
//
g_pDiagCtx->Printf (ttidBeDiag,
"Step 9: Notify: apply PnP changes\n");
for (iter = m_DirtyComponents.begin();
iter != m_DirtyComponents.end();
iter++)
{
pComponent = *iter;
Assert (pComponent);
pComponent->Notify.ApplyPnpChanges (
pNetConfig->Notify.PINetCfg(),
&fRebootNeeded);
if (fRebootNeeded)
{
g_pDiagCtx->Printf (ttidBeDiag,
" %S notify object wants a reboot\n",
pComponent->m_pszInfId);
// If the component has been removed, treat the reboot
// as mandatory. (The reason being that we cannot risk a
// failed re-install.) We put the component into lockdown
// in this situation.
//
if (!pNetConfig->Core.Components.FComponentInList (pComponent))
{
m_fRebootRequired = TRUE;
LockdownComponentUntilNextReboot (pComponent->m_pszInfId);
}
else
{
m_fRebootRecommended = TRUE;
}
}
}
//+-----------------------------------------------------------------------
// Step 10: Release notify objects for removed components and
// process any DelFiles in the remove section of their INF.
//
g_pDiagCtx->Printf (ttidBeDiag,
"Step 10: Release notify objects for removed components:\n");
for (iter = m_DirtyComponents.begin();
iter != m_DirtyComponents.end();
iter++)
{
pComponent = *iter;
Assert (pComponent);
// Skip enumerated components (they don't have notify objects), and
// Skip components that were not removed.
// Skip components that don't have their INF open (like unsupported
// components that get removed during GUI setup.)
//
if (FIsEnumerated (pComponent->Class()) ||
pNetConfig->Core.Components.FComponentInList (pComponent) ||
!pComponent->GetCachedInfFile())
{
continue;
}
pComponent->Notify.ReleaseNotifyObject(NULL, FALSE);
fCallCoFreeUnusedLibraries = TRUE;
}
if (fCallCoFreeUnusedLibraries)
{
g_pDiagCtx->Printf (ttidBeDiag,
" calling CoFreeUnusedLibraries before running remove sections\n");
// Now ask COM to unload any DLLs hosting COM objects that are no longer
// in use. (This is a bit heavy-handed as it affects the entire process,
// but there is currently no other way to safely unload the DLLs hosting
// the notify objects of the removed components.)
//
CoFreeUnusedLibrariesEx(0, 0);
for (iter = m_DirtyComponents.begin();
iter != m_DirtyComponents.end();
iter++)
{
pComponent = *iter;
Assert (pComponent);
// Skip enumerated components (they don't have notify objects), and
// Skip components that were not removed.
// Skip components that don't have their INF open (like unsupported
// components that get removed during GUI setup.)
//
if (FIsEnumerated (pComponent->Class()) ||
pNetConfig->Core.Components.FComponentInList (pComponent) ||
!pComponent->GetCachedInfFile())
{
continue;
}
g_pDiagCtx->Printf (ttidBeDiag,
" %S [%S]\n", pComponent->PszGetPnpIdOrInfId(),
pComponent->m_strRemoveSection.c_str());
(VOID) HrCiInstallFromInfSection(
pComponent->GetCachedInfFile(),
pComponent->m_strRemoveSection.c_str(),
NULL, NULL, SPINST_FILES);
}
}
/*
//+-----------------------------------------------------------------------
// Step 11: Reconfigure moved bindings
//
// If we changed binding order, Send PnP RECONFIGURE for all dirty
// components that are neither installed nor removed so we
// pickup these order changes.
//
for (iter = m_DirtyComponents.begin();
iter != m_DirtyComponents.end();
iter++)
{
pComponent = *iter;
Assert (pComponent);
// Skip components that have been newly installed or removed.
//
if (!pNetConfig->Core.Components.FComponentInList (pComponent) ||
!m_CoreStartedWith.Components.FComponentInList (pComponent))
{
continue;
}
// Note: send RECONFIGURE
}
*/
}
HRESULT
CModifyContext::HrEnableOrDisableBindPath (
IN DWORD dwChangeFlag,
IN CBindPath* pBindPath,
IN INetCfgBindingPath* pIPath OPTIONAL)
{
TraceFileFunc(ttidNetcfgBase);
HRESULT hr;
CNetConfig* pNetConfig;
UINT CountBefore;
Assert (this);
Assert (S_OK == m_hr);
Assert (m_fPrepared);
Assert ((dwChangeFlag == NCN_ENABLE) || (dwChangeFlag == NCN_DISABLE));
Assert (pBindPath);
hr = S_OK;
pNetConfig = PNetConfig();
// Get the count of bindpaths currently disabled. If it changes
// after we enable/disable this one, we'll inform notify objects
// about it. If the count does not change, it means the state
// of the bindpath has not changed.
//
CountBefore = pNetConfig->Core.DisabledBindings.CountBindPaths();
if (NCN_ENABLE == dwChangeFlag)
{
pNetConfig->Core.EnableBindPath (pBindPath);
Assert (S_OK == hr);
}
else
{
hr = pNetConfig->Core.HrDisableBindPath (pBindPath);
}
if ((S_OK == hr) &&
(pNetConfig->Core.DisabledBindings.CountBindPaths() != CountBefore))
{
// Note: Need to protect against bad notify objects that
// switch the state of a bindpath we are notifying for.
// This could cause an infinite loop. Solve by adding a
// recursion count and bindset to the modify context dedicated
// to bindpath enabling/disabling. When the count is zero,
// we clear the bindingset, add the bindpath we are about to
// notify for, increment the recursion count and call
// NotifyBindPath. When the call returns, we decrement the
// recursion count, remove the bindpath from the binding set,
// and return. Before we call NotifyBindPath when the recursion
// count is non-zero, if the bindpath is already in the
// bindingset, we don't call.
//
pNetConfig->Notify.NotifyBindPath (dwChangeFlag, pBindPath, pIPath);
}
TraceHr (ttidError, FAL, hr, FALSE,
"CModifyContext::HrEnableOrDisableBindPath");
return hr;
}
VOID
CModifyContext::InstallOrRemoveRequiredComponents (
IN CComponent* pComponent,
IN IOR_ACTION Action)
{
TraceFileFunc(ttidNetcfgBase);
HRESULT hr;
HKEY hkeyInstance;
PWSTR pszRequiredList;
const WCHAR szDelims[] = L", ";
Assert (this);
Assert (S_OK == m_hr);
Assert (m_fPrepared);
Assert (pComponent);
Assert ((IOR_INSTALL == Action) || (IOR_REMOVE == Action));
pszRequiredList = NULL;
// Open the instance key of the component and read the RequireAll value.
// This value may not exist, which is okay, it means we have nothing
// to do.
//
hr = pComponent->HrOpenInstanceKey (KEY_READ, &hkeyInstance, NULL, NULL);
if (S_OK == hr)
{
HKEY hkeyNdi;
hr = HrRegOpenKeyEx (hkeyInstance, L"Ndi", KEY_READ, &hkeyNdi);
if (S_OK == hr)
{
hr = HrRegQuerySzWithAlloc (hkeyNdi, L"RequiredAll",
&pszRequiredList);
RegCloseKey (hkeyNdi);
}
if (HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) == hr)
{
hr = S_OK;
Assert (!pszRequiredList);
}
RegCloseKey (hkeyInstance);
}
// If we have a list of required components, install or remove them.
//
if ((S_OK == hr) && pszRequiredList)
{
CNetConfig* pNetConfig;
INetCfgComponent* pIComp;
pNetConfig = PNetConfig();
hr = pComponent->HrGetINetCfgComponentInterface (
pNetConfig->Notify.PINetCfg(),
&pIComp);
if (S_OK == hr)
{
PCWSTR pszInfId;
PWSTR pszNextInfId;
OBO_TOKEN OboToken;
CComponent* pComponentToRemove;
WCHAR szInfFile [_MAX_PATH];
ZeroMemory (&OboToken, sizeof(OboToken));
OboToken.Type = OBO_COMPONENT;
OboToken.pncc = pIComp;
// For each INF ID in the comma separate list of required
// components...
//
for (pszInfId = GetNextStringToken (pszRequiredList, szDelims, &pszNextInfId);
pszInfId && *pszInfId;
pszInfId = GetNextStringToken (NULL, szDelims, &pszNextInfId))
{
if (IOR_INSTALL == Action)
{
NETWORK_INSTALL_PARAMS nip;
COMPONENT_INSTALL_PARAMS Params;
ZeroMemory (&Params, sizeof(Params));
// Get the Class corresponding to the INF ID.
//
m_hr = HrCiGetClassAndInfFileOfInfId (
pszInfId, &Params.Class, szInfFile);
if (S_OK != m_hr)
{
break;
}
//$REVIEW:Should we stick the filename in the
// COMPONENT_INSTALL_PARAMS so that we don't grovel
// the INF directory to find it again?
// If so, store the filename buffer in the modify
// context so we don't take up stack space or heap space.
// Just need to be sure that we use it to install the
// component before we recurse and overwrite it.
// Pack the network install parameters and call the common
// function.
//
//$REVIEW: we probably need dwSetupFlags and dwUpgradeFromBuildNo
// in the modify context saved when it was called at
// recursion depth 0. Otherwise, things installed here
// during GUI setup will have wrong parameters.
//
nip.dwSetupFlags = 0;
nip.dwUpgradeFromBuildNo = 0;
nip.pszAnswerFile = NULL;
nip.pszAnswerSection = NULL;
// Setup the component install parameters.
//
Params.pszInfId = pszInfId;
Params.pszInfFile = szInfFile;
Params.pOboToken = FIsEnumerated (Params.Class)
? NULL : &OboToken;
Params.pnip = &nip;
//
// THIS MAY CAUSE RECURSION
//
// (just using pComponentToRemove as a placeholder
// for a required parameter.)
//
HrInstallNewOrReferenceExistingComponent (
Params, &pComponentToRemove);
if (S_OK != m_hr)
{
break;
}
}
else
{
Assert (IOR_REMOVE == Action);
// Search for the component to remove using its INF ID.
//
pComponentToRemove = pNetConfig->Core.Components.
PFindComponentByInfId (pszInfId, NULL);
if (pComponentToRemove)
{
//
// THIS MAY CAUSE RECURSION
//
HrRemoveComponentIfNotReferenced (
pComponentToRemove,
FIsEnumerated (pComponentToRemove->Class())
? NULL
: &OboToken,
NULL);
if (S_OK != m_hr)
{
break;
}
}
}
}
ReleaseObj (pIComp);
}
MemFree (pszRequiredList);
}
}
//----------------------------------------------------------------------------
// Update a component. Do this by generating the bindings which involve
// the component and noting them as 'OldBindPaths'. The stack entries which
// involve the component are removed and re-generated and the bindings which
// involve the component are again noted as 'NewBindPaths'. The old bindings
// are compared to the new bindings and the differences are notified to
// notify objects as either being removed or added. For any removed bindings,
// we also remove them from the core's disabled set if they happen to exist
// there too.
//
// Assumptions:
// The INF for pComponent has already been re-run so that the potentially
// new values for UpperRange, LowerRange, etc. are present in the registry.
//
// pComponent has had its external data loaded already.
//
HRESULT
CModifyContext::HrUpdateComponent (
IN CComponent* pComponent,
IN DWORD dwSetupFlags,
IN DWORD dwUpgradeFromBuildNo)
{
TraceFileFunc(ttidNetcfgBase);
HRESULT hr;
CNetConfig* pNetConfig;
CBindingSet OldBindPaths;
CBindingSet NewBindPaths;
CBindPath* pScan;
Assert (this);
Assert (S_OK == m_hr);
Assert (m_fPrepared);
Assert (pComponent);
pNetConfig = PNetConfig();
// Now that we actually are going to modify something, push a new
// recursion depth.
//
PushRecursionDepth();
Assert (S_OK == m_hr);
// Generate the "old" bindings by noting those which involve the
// component.
//
hr = pNetConfig->Core.HrGetBindingsInvolvingComponent (
pComponent,
GBF_ONLY_WHICH_CONTAIN_COMPONENT,
&OldBindPaths);
if (S_OK != hr)
{
goto finished;
}
// Reload the external data so we pickup what the possibly updated
// INF has changed.
//
hr = pComponent->Ext.HrReloadExternalData ();
if (S_OK != hr)
{
goto finished;
}
// Update the stack table entries for the component.
//
hr = pNetConfig->Core.StackTable.HrUpdateEntriesForComponent (
pComponent,
&pNetConfig->Core.Components,
INS_SORTED);
if (S_OK != hr)
{
// This is not good. We ripped out the stack entries and failed
// putting them back in. The stack table now has no entries for
// this component. Prevent this from being applied by setting the
// modify context's HRESULT to the error.
//
m_hr = hr;
goto finished;
}
// Generate the "new" bindings by noting those which involve the
// component.
//
hr = pNetConfig->Core.HrGetBindingsInvolvingComponent (
pComponent,
GBF_ONLY_WHICH_CONTAIN_COMPONENT,
&NewBindPaths);
if (S_OK != hr)
{
// Probably out of memory. Prevent apply by setting the modify
// context's HRESULT to the error.
//
m_hr = hr;
goto finished;
}
// Notify any bindpaths which have been removed.
//
for (pScan = OldBindPaths.begin();
pScan != OldBindPaths.end();
pScan++)
{
if (NewBindPaths.FContainsBindPath (pScan))
{
continue;
}
m_DeletedBindPaths.HrAddBindPath (pScan, INS_IGNORE_IF_DUP | INS_APPEND);
pNetConfig->Core.DisabledBindings.RemoveBindPath (pScan);
pNetConfig->Notify.NotifyBindPath (NCN_REMOVE, pScan, NULL);
}
// Notify any bindpaths which have been added.
//
for (pScan = NewBindPaths.begin();
pScan != NewBindPaths.end();
pScan++)
{
if (OldBindPaths.FContainsBindPath (pScan))
{
continue;
}
m_AddedBindPaths.HrAddBindPath (pScan, INS_IGNORE_IF_DUP | INS_APPEND);
pNetConfig->Notify.NotifyBindPath (NCN_ADD | NCN_ENABLE, pScan, NULL);
}
// Notify that the component has been updated.
//
pNetConfig->Notify.ComponentUpdated (pComponent,
dwSetupFlags,
dwUpgradeFromBuildNo);
finished:
hr = HrPopRecursionDepth();
TraceHr (ttidError, FAL, hr, FALSE,
"CModifyContext::HrUpdateComponent (%S)",
pComponent->PszGetPnpIdOrInfId());
return hr;
}