NetUpgradeAddSection function
This function is obsolete for Microsoft Windows XP (SP1 and later), Microsoft Windows Server 2003, and later operating systems.
NetUpgradeAddSection adds a section to the AnswerFile.
Syntax
LONG __stdcall NetUpgradeAddSection(
_In_ LPCTSTR szSectionName
);
Parameters
- szSectionName [in]
Name of the section to add to the AnswerFile.
Return value
NetUpgradeAddSection can return one of the following:
| Return code | Description |
|---|---|
| ERROR_SUCCESS | Specified section was added to the AnswerFile. |
| ERROR_INVALID_PARAMETER | Parameter szSectionName is invalid. |
Any other return value indicates a fatal error.
Remarks
A network migration DLL calls NetUpgradeAddSection in the context of its DoPreUpgradeProcessing function to add a section name to the AnswerFile ( winnt.sif). NetSetup uses the AnswerFile during the operating system upgrade to migrate network components to upgraded operating system.
Typically, a network migration DLL calls NetUpgradeAddSection to add a component OEM-section to the AnswerFile. A component OEM-section has the following format:
params.post-upgrade-ID.OemSection
where
post-upgrade-ID is the Windows 2000 or later hw-id of the network component to be upgraded.
A network migration DLL can add other sections to the AnswerFile. For example, the DLL can add a section to be run by NetSetup after the upgrade operating system is installed. This section could contain an AddReg directive that references an Add-registry-section added by the network migration DLL.
To add an entry to an AnswerFile section that it has created, the network migration DLL calls NetUpgradeAddLineToSection.
Requirements
Target platform |
Desktop |
Version |
Obsolete for Microsoft Windows XP with SP1 and later service packs, Microsoft Windows Server 2003, and later operating systems. |
Header |
Oemupgex.h (include OemUpGex.h) |
See also