IVsPersistSolutionOpts2::LoadUserOptionsEx Method (Int32, IVsSolutionPersistence^, UInt32)

 

Loads user options for a given solution.

Namespace:   Microsoft.VisualStudio.Shell.Interop
Assembly:  Microsoft.VisualStudio.Shell.Interop.11.0 (in Microsoft.VisualStudio.Shell.Interop.11.0.dll)

void LoadUserOptionsEx(
	int fPreLoad,
	IVsSolutionPersistence^ pPersistence,
	unsigned int grfLoadOpts
)

Parameters

fPreLoad
Type: System::Int32

[in] Inidicates if any user options are to be preloaded. If true, the user options are preloaded.

pPersistence
Type: Microsoft.VisualStudio.Shell.Interop::IVsSolutionPersistence^

[in] Pointer to the IVsSolutionPersistence interface on which the VSPackage should call its LoadPackageUserOpts method for each stream name it wants to read from the user options (.opt) file.

grfLoadOpts
Type: System::UInt32

[in] User options whose value is taken from the __VSLOADUSEROPTS DWORD.

If your package implements IVsPersistSolutionOpts2, this method is called in preference to LoadUserOptions when opening the solution, after all synchronously loaded projects are opened, with fPreLoad=false. In addition, this method is also called for the same Solution User Options (SUO) immediately before any synchronous loaded projects are opened, with fPreLoad=true. This allows the package to preload any user options that may be queried by project factories while opening projects. LoadUserOptions(pPersistence, grfLoadOpts) behaves the same as LoadUserOptionsEx(FALSE, pPersistence, grfLoadOpts).

Return to top
Show: