Freigeben über

Methoden der IADsService-Eigenschaft

  • Artikel

Die Eigenschaftenmethoden der IADsService-Schnittstelle lesen und schreiben die in diesem Thema beschriebenen Eigenschaften. Weitere Informationen finden Sie unter Schnittstelleneigenschaftenmethoden.

Eigenschaften

Abhängigkeiten

Array von BSTR-Namen von Diensten oder Ladegruppen, die geladen werden müssen, damit dieser Dienst geladen werden kann. Die Syntax für den Eintrag lautet "Service:", gefolgt vom Dienstnamen oder "Group:" gefolgt vom Namen der Ladegruppe.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: VARIANT

// C++ method syntax
HRESULT get_Dependencies(
  [out] VARIANT* pvServiceDepend
);
HRESULT put_Dependencies(
  [in] VARIANT vServiceDepend
);

DisplayName

Der Anzeigename des Diensts.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_DisplayName(
  [out] BSTR* pbstrDisplayName
);
HRESULT put_DisplayName(
  [in] BSTR bstrDisplayName
);

ErrorControl

Die Aktion, die ausgeführt werden soll, wenn dieser Dienst beim Start fehlschlägt. Im Folgenden sind gültige Werte für diese Eigenschaft aufgeführt.

ADS_SERVICE_ERROR_IGNORE

Das Startprogramm protokolliert den Fehler, setzt den Startvorgang jedoch fort.

ADS_SERVICE_ERROR_NORMAL

Das Startprogramm protokolliert den Fehler und zeigt ein Meldungsfeld an, setzt den Startvorgang jedoch fort.

ADS_SERVICE_ERROR_SEVERE

Das Startprogramm protokolliert den Fehler. Wenn die letzte als fehlerfrei bekannte Konfiguration gestartet wird, wird der Startvorgang fortgesetzt. Andernfalls wird das System mit der letzten als fehlerfrei bekannten Konfiguration neu gestartet.

ADS_SERVICE_ERROR_CRITICAL

Das Startprogramm protokolliert den Fehler nach Möglichkeit. Wenn diese Konfiguration gestartet wird, schlägt der Startvorgang fehl. Andernfalls wird das System mit der zuletzt bekannten guten Konfiguration neu gestartet.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: LONG

// C++ method syntax
HRESULT get_ErrorControl(
  [out] LONG* plErrorControl
);
HRESULT put_ErrorControl(
  [in] LONG lErrorControl
);

HostComputer

Die ADsPath-Zeichenfolge des Hosts dieses Diensts.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_HostComputer(
  [out] BSTR* pbstrHostComputer
);
HRESULT put_HostComputer(
  [in] BSTR bstrHostComputer
);

LoadOrderGroup

Name der Ladereihenfolgegruppe, der dieser Dienst angehört.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_LoadOrderGroup(
  [out] BSTR* pbstrLoadOrderGroup
);
HRESULT put_LoadOrderGroup(
  [in] BSTR bstrLoadOrderGroup
);

Pfad

Pfad und Dateiname der ausführbaren Datei dieses Diensts.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_Path(
  [out] BSTR* pbstrPath
);
HRESULT put_Path(
  [in] BSTR bstrPath
);

ServiceAccountName

Name des Kontos, das dieser Dienst verwendet, um sich beim Start zu authentifizieren.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_ServiceAccountName(
  [out] BSTR* pbstrServiceAccountName
);
HRESULT put_ServiceAccountName(
  [in] BSTR bstrServiceAccountName
);

ServiceAccountPath

Pfad des Kontos, das von der ServiceAccountPath-Eigenschaft angegeben wird.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_ServiceAccountPath(
  [out] BSTR* pbstrServiceAccountPath
);
HRESULT put_ServiceAccountPath(
  [in] BSTR bstrServiceAccountPath
);

Servicetype

Die Beschreibung der Darstellung eines Diensts auf dem Hostcomputer. Diese Eigenschaft kann null oder eine Kombination aus einem oder mehreren der folgenden Werte sein.

ADS_SERVICE_KERNEL_DRIVER (0x00000001)

ADS_SERVICE_FILE_SYSTEM_DRIVER (0x00000002)

ADS_SERVICE_OWN_PROCESS (0x00000010)

ADS_SERVICE_SHARE_PROCESS (0x00000020)

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: LONG

// C++ method syntax
HRESULT get_ServiceType(
  [out] LONG* plServiceType
);
HRESULT put_ServiceType(
  [in] LONG lServiceType
);

Starttyp

Bestimmt, wie der Dienst gestartet werden soll. Im Folgenden sind gültige Werte für diese Eigenschaft aufgeführt.

ADS_SERVICE_BOOT_START

Der Dienst ist ein Gerätetreiber, der vom Systemladeprogramm gestartet wird. Dieses Wert ist nur für Treiberdienste gültig.

ADS_SERVICE_SYSTEM_START

Der Dienst ist ein Gerätetreiber, der von der IoInitSystem-Funktion gestartet wird. Dieses Wert ist nur für Treiberdienste gültig.

ADS_SERVICE_AUTO_START

Der Dienst wird während des Systemstarts automatisch vom Dienststeuerungs-Manager gestartet.

ADS_SERVICE_DEMAND_START

Der Dienst wird vom Dienststeuerungs-Manager gestartet, wenn ein Prozess die StartService-Funktion aufruft.

ADS_SERVICE_DISABLED

Der Dienst kann nicht gestartet werden. Versuche, den Dienst zu starten, führen zum Fehlercode ERROR_SERVICE_DISABLED.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: LONG

// C++ method syntax
HRESULT get_StartType(
  [out] LONG* plStartType
);
HRESULT put_StartType(
  [in] LONG lStartType
);

StartupParameters

Parameter, die beim Start an den Dienst übergeben werden.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_StartupParameters(
  [out] BSTR* pbstrStartupParameters
);
HRESULT put_StartupParameters(
  [in] BSTR bstrStartupParameters
);

Version

Version des Diensts.

Zugriffstyp: Lese-/Schreibzugriff

Skriptdatentyp: BSTR

// C++ method syntax
HRESULT get_Version(
  [out] BSTR* pbstrVersion
);
HRESULT put_Version(
  [in] BSTR bstrVersion
);

Beispiele

Das folgende Codebeispiel zeigt, wie alle verfügbaren Systemdienste aufgelistet werden, die auf dem Hostcomputer "myMachine" ausgeführt werden, zusammen mit dem Speicherort, an dem die ausführbaren Dateien der Dienste gefunden werden.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows Vista
Unterstützte Mindestversion (Server)
 WindowsServer 2008
Header
Iads.h
DLL
Activeds.dll
IID
 IID_IADsService ist definiert als 68AF66E0-31CA-11CF-A98A-00AA006BC149

Siehe auch

IADsService

Methoden der Interface-Eigenschaft