This documentation is archived and is not being maintained.
ServiceInstallerDialogResult Enumeration
Visual Studio 2010
Specifies the return value of a ServiceInstallerDialog form.
Assembly: System.ServiceProcess (in System.ServiceProcess.dll)
| Member name | Description | |
|---|---|---|
| OK | The dialog return value is OK. This value typically indicates that the user confirmed the account properties and pressed the OK button to close the dialog. | |
| UseSystem | Install the service with a system account rather than a user account. This value typically indicates that the dialog was not displayed to the user. For example, the ServiceProcessInstaller::Account property is set to something other than User. | |
| Canceled | The dialog return value is Canceled. This value typically indicates that the user canceled out of the dialog without setting the account fields. |
The ServiceInstallerDialog::Result property uses this enumeration to indicate the user response to the dialog box.
The following example uses a ServiceInstallerDialog to prompt the user for a service installation account.
// Prompt the user for service installation account values. public: static bool GetServiceAccount( interior_ptr<ServiceProcessInstaller^> svcInst ) { bool accountSet = false; ServiceInstallerDialog^ svcDialog = gcnew ServiceInstallerDialog; // Query the user for the service account type. do { svcDialog->TopMost = true; svcDialog->ShowDialog(); if ( svcDialog->Result == ServiceInstallerDialogResult::OK ) { // Do a very simple validation on the user // input. Check to see whether the user name // or password is blank. if ( (svcDialog->Username->Length > 0) && (svcDialog->Password->Length > 0) ) { // Use the account and password. accountSet = true; ( *svcInst)->Account = ServiceAccount::User; ( *svcInst)->Username = svcDialog->Username; ( *svcInst)->Password = svcDialog->Password; } } else if ( svcDialog->Result == ServiceInstallerDialogResult::UseSystem ) { ( *svcInst)->Account = ServiceAccount::LocalSystem; ( *svcInst)->Username = nullptr; ( *svcInst)->Password = nullptr; accountSet = true; } if ( !accountSet ) { // Display a message box. Tell the user to // enter a valid user and password, or cancel // out to leave the service account alone. DialogResult result; result = MessageBox::Show( "Invalid user name or password for service installation." " Press Cancel to leave the service account unchanged.", "Change Service Account", MessageBoxButtons::OKCancel, MessageBoxIcon::Hand ); if ( result == DialogResult::Cancel ) { // Break out of loop. break; } } } while ( !accountSet ); return accountSet; }
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: