IADsService プロパティ メソッド
IADsService インターフェイスのプロパティ メソッドは、このトピックで説明するプロパティの読み取りと書き込みを行います。 詳細については、「 インターフェイス プロパティ メソッド」を参照してください。
プロパティ
-
依存関係
-
-
アクセスの種類: 読み取り/書き込み
-
スクリプト データ型: VARIANT
-
// C++ method syntax HRESULT get_Dependencies( [out] VARIANT* pvServiceDepend ); HRESULT put_Dependencies( [in] VARIANT vServiceDepend );
このサービスを読み込むには、読み込む必要があるサービスまたは読み込みグループの BSTR 名の配列。 エントリの構文は、"Service:" の後にサービス名、または "Group:" の後に読み込みグループ名が続きます。
-
-
表示名
-
-
アクセスの種類: 読み取り/書き込み
-
スクリプト データ型: BSTR
-
// C++ method syntax HRESULT get_DisplayName( [out] BSTR* pbstrDisplayName ); HRESULT put_DisplayName( [in] BSTR bstrDisplayName );
サービスのフレンドリ名。
-
-
ErrorControl
-
-
ADS_SERVICE_ERROR_IGNORE
-
スタートアップ プログラムはエラーをログに記録しますが、起動操作を続行します。
-
ADS_SERVICE_ERROR_NORMAL
-
スタートアップ プログラムはエラーをログに記録し、メッセージ ボックスを表示しますが、起動操作を続行します。
-
ADS_SERVICE_ERROR_SEVERE
-
スタートアップ プログラムによってエラーがログに記録されます。 最後に正常な構成が開始された場合、スタートアップ操作は続行されます。 それ以外の場合、システムは最後に正常な構成で再起動されます。
-
ADS_SERVICE_ERROR_CRITICAL
-
スタートアップ プログラムは、可能な場合はエラーをログに記録します。 最後に正常な構成が開始されている場合、スタートアップ操作は失敗します。 それ以外の場合、システムは最後に既知の適切な構成で再起動されます。
このサービスが起動時に失敗した場合に実行されるアクション。 このプロパティの有効な値を次に示します。
-
-
アクセスの種類: 読み取り/書き込み
-
スクリプト データ型: LONG
-
// C++ method syntax HRESULT get_ErrorControl( [out] LONG* plErrorControl ); HRESULT put_ErrorControl( [in] LONG lErrorControl );
HostComputer
-
アクセスの種類: 読み取り/書き込み
-
スクリプト データ型: BSTR
-
// C++ method syntax HRESULT get_HostComputer( [out] BSTR* pbstrHostComputer ); HRESULT put_HostComputer( [in] BSTR bstrHostComputer );
このサービスのホストの ADsPath 文字列。
LoadOrderGroup
-
アクセスの種類: 読み取り/書き込み
-
スクリプト データ型: BSTR
-
// C++ method syntax HRESULT get_LoadOrderGroup( [out] BSTR* pbstrLoadOrderGroup ); HRESULT put_LoadOrderGroup( [in] BSTR bstrLoadOrderGroup );
このサービスがメンバーであるロード注文グループの名前。
パス
-
アクセスの種類: 読み取り/書き込み
-
スクリプト データ型: BSTR
-
// C++ method syntax HRESULT get_Path( [out] BSTR* pbstrPath ); HRESULT put_Path( [in] BSTR bstrPath );
このサービスの実行可能ファイルへのパスとファイル名。
ServiceAccountName
-
アクセスの種類: 読み取り/書き込み
-
スクリプト データ型: BSTR
-
// C++ method syntax HRESULT get_ServiceAccountName( [out] BSTR* pbstrServiceAccountName ); HRESULT put_ServiceAccountName( [in] BSTR bstrServiceAccountName );
このサービスが起動時に自身を認証するために使用するアカウントの名前。
ServiceAccountPath
-
アクセスの種類: 読み取り/書き込み
-
スクリプト データ型: BSTR
-
// C++ method syntax HRESULT get_ServiceAccountPath( [out] BSTR* pbstrServiceAccountPath ); HRESULT put_ServiceAccountPath( [in] BSTR bstrServiceAccountPath );
ServiceAccountPath プロパティで指定されたアカウントのパス。
ServiceType
-
ADS_SERVICE_KERNEL_DRIVER (0x00000001)
-
ADS_SERVICE_FILE_SYSTEM_DRIVER (0x00000002)
-
ADS_SERVICE_OWN_PROCESS (0x00000010)
-
ADS_SERVICE_SHARE_PROCESS (0x00000020)
サービスがホスト コンピューター上でどのように表示されるかの説明。 このプロパティには、0 または次の値の 1 つ以上の組み合わせを指定できます。
アクセスの種類: 読み取り/書き込み
スクリプト データ型: LONG
// C++ method syntax
HRESULT get_ServiceType(
[out] LONG* plServiceType
);
HRESULT put_ServiceType(
[in] LONG lServiceType
);
StartType
-
ADS_SERVICE_BOOT_START
-
このサービスは、システム ローダーによって開始されたデバイス ドライバーです。 この値は、ドライバー サービスに対してのみ指定できます。
-
ADS_SERVICE_SYSTEM_START
-
サービスは、 IoInitSystem 関数によって開始されたデバイス ドライバーです。 この値は、ドライバー サービスに対してのみ指定できます。
-
ADS_SERVICE_AUTO_START
-
サービスは、システムの起動時にサービス コントロール マネージャーによって自動的に開始されます。
-
ADS_SERVICE_DEMAND_START
-
プロセスが StartService 関数を呼び出すと、サービスコントロールマネージャーによってサービスが開始されます。
-
ADS_SERVICE_DISABLED
-
サービスは開始できません。 エラー コード ERROR_SERVICE_DISABLEDでサービスの開始を試みます。
サービスを開始する方法を決定します。 このプロパティの有効な値を次に示します。
アクセスの種類: 読み取り/書き込み
スクリプト データ型: LONG
// C++ method syntax
HRESULT get_StartType(
[out] LONG* plStartType
);
HRESULT put_StartType(
[in] LONG lStartType
);
StartupParameters
-
アクセスの種類: 読み取り/書き込み
-
スクリプト データ型: BSTR
-
// C++ method syntax HRESULT get_StartupParameters( [out] BSTR* pbstrStartupParameters ); HRESULT put_StartupParameters( [in] BSTR bstrStartupParameters );
起動時にサービスに渡されるパラメーター。
バージョン
-
アクセスの種類: 読み取り/書き込み
-
スクリプト データ型: BSTR
-
// C++ method syntax HRESULT get_Version( [out] BSTR* pbstrVersion ); HRESULT put_Version( [in] BSTR bstrVersion );
サービスのバージョン。
例
次のコード例は、ホスト コンピューター "myMachine" で実行されているすべての利用可能なシステム サービスを、サービスの実行可能ファイルを検索する場所と共に一覧表示する方法を示しています。
Dim cp As IADsComputer
On Error GoTo Cleanup
Set cp = GetObject("WinNT://myMachine,computer")
If (IsEmpty(cp) = False) Then
cp.Filter = Array("Service")
For Each service In cp
MsgBox service.Name & " @" & service.path
Next
End if
Cleanup:
If (Err.Number<>0) Then
MsgBox("An error has occurred. " & Err.Number)
End If
Set cp = Nothing
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows Vista |
サポートされている最小のサーバー |
Windows Server 2008 |
Header |
|
[DLL] |
|
IID |
IID_IADsServiceは 68AF66E0-31CA-11CF-A98A-00AA006BC149 として定義されています |