.NET Framework クラス ライブラリ リファレンス

ServiceInstallerDialog.Result プロパティ

サービス アカウント フォームのダイアログ ボックスの結果を取得します。

名前空間: System.ServiceProcess.Design
アセンブリ: System.ServiceProcess (system.serviceprocess.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 Result As ServiceInstallerDialogResult

Visual Basic (使用法)

Dim instance As ServiceInstallerDialog
Dim value As ServiceInstallerDialogResult

value = instance.Result

C#

public ServiceInstallerDialogResult Result { get;
 }

C++

public:
property ServiceInstallerDialogResult Result {
    ServiceInstallerDialogResult get ();
}

J#

/** @property */
public ServiceInstallerDialogResult get_Result ()

JScript

public function get Result
 () : ServiceInstallerDialogResult

プロパティ値
ダイアログ ボックスに対するユーザーの応答を示す ServiceInstallerDialogResult。既定値は OK です。

解説

ShowDialog を使用してサービス インストール アカウントの入力をユーザーに要求してから、Result の値を確認してください。この値が OK の場合は、入力値 Username と Password が有効であることを検証してください。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ServiceInstallerDialog クラス
ServiceInstallerDialog メンバ
System.ServiceProcess.Design 名前空間
ServiceInstallerDialogResult

---

ServiceInstallerDialogResult 列挙体

ServiceInstallerDialog フォームの戻り値を指定します。

名前空間: System.ServiceProcess.Design
アセンブリ: System.ServiceProcess (system.serviceprocess.dll 内)
構文

Visual Basic (宣言)

Public Enumeration ServiceInstallerDialogResult

Visual Basic (使用法)

Dim instance As ServiceInstallerDialogResult

C#

public enum ServiceInstallerDialogResult

C++

public enum class ServiceInstallerDialogResult

J#

public enum ServiceInstallerDialogResult

JScript

public enum ServiceInstallerDialogResult

メンバ

	メンバ名	説明
	Canceled	ダイアログの戻り値は Canceled です。通常、この値はユーザーがアカウントのフィールドを設定せずにダイアログをキャンセルして終了したことを示します。
	OK	ダイアログの戻り値は OK です。通常、この値はユーザーがアカウントのプロパティを確認し、[OK] ボタンを押してダイアログを閉じたことを示します。
	UseSystem	ユーザー アカウントではなく、システム アカウントを使用してサービスをインストールします。通常、この値はダイアログがユーザーに表示されなかったことを示します。たとえば、ServiceProcessInstaller.Account プロパティが User 以外に設定されています。

解説

ServiceInstallerDialog.Result プロパティは、この列挙体を使用して、ダイアログ ボックスへのユーザー応答を示します。

使用例

ServiceInstallerDialog を使用して、ユーザーにサービス インストール アカウントを入力するように要求するプロンプトを表示する例を次に示します。

C#

// Prompt the user for service installation account values.
public static bool GetServiceAccount(ref
 ServiceProcessInstaller svcInst)
{
    bool accountSet = false;
    ServiceInstallerDialog svcDialog = new 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 = null;
            svcInst.Password = null;
            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;
}

C++

   // 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;
   }

J#

// Prompt the user for service installation account values.
public static boolean GetServiceAccount(ServiceProcessInstaller
 svcInst)
{
    boolean accountSet = false;
    ServiceInstallerDialog svcDialog = new ServiceInstallerDialog();
    // Query the user for the service account type.
    do {
        svcDialog.set_TopMost(true);
        svcDialog.ShowDialog();

        if (svcDialog.get_Result().Equals(ServiceInstallerDialogResult.OK))
        {
            // Do a very simple validation on the user
            // input.  Check to see whether the user name
            // or password is blank.
            if (svcDialog.get_Username().get_Length() > 0 
                && svcDialog.get_Password().get_Length() > 0) {
                // Use the account and password.
                accountSet = true;

                svcInst.set_Account(ServiceAccount.User);
                svcInst.set_Username(svcDialog.get_Username());
                svcInst.set_Password(svcDialog.get_Password());
            }
        }
        else {
            if (svcDialog.get_Result().Equals(ServiceInstallerDialogResult.
                UseSystem)) {
                svcInst.set_Account(ServiceAccount.LocalSystem);
                svcInst.set_Username(null);
                svcInst.set_Password(null);
                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.Equals(DialogResult.Cancel)) {
                // Break out of loop.
                break;
            }
        }
    } while (!(accountSet));
    return accountSet;
} //GetServiceAccount

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
System.ServiceProcess.Design 名前空間
ServiceInstallerDialog クラス
ServiceAccount 列挙体