IADsService-Eigenschaftsmethoden

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

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: Lesen/Schreiben

Skriptdatentyp: VARIANT

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

DisplayName

Der Anzeigename des Diensts.

Zugriffstyp: Lesen/Schreiben

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 angegeben.

_ADS-DIENSTFEHLER _ _ IGNORE

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

_ADS-DIENSTFEHLER _ _ NORMAL

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

_ADS-DIENSTFEHLER _ _ SCHWERWIEGEND

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

_ADS-DIENSTFEHLER _ _ KRITISCH

Das Startprogramm protokolliert den Fehler nach Möglichkeit. Wenn die letzte als funktionierend bekannte Konfiguration gestartet wird, schlägt der Startvorgang fehl. Andernfalls wird das System mit der letzten bekannten guten Konfiguration neu gestartet.

Zugriffstyp: Lesen/Schreiben

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: Lesen/Schreiben

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: Lesen/Schreiben

Skriptdatentyp: BSTR

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

Path

Pfad und Dateiname zur ausführbaren Datei dieses Diensts.

Zugriffstyp: Lesen/Schreiben

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 selbst zu authentifizieren.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: BSTR

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

ServiceAccountPath

Pfad des von der ServiceAccountPath-Eigenschaft angegebenen Kontos.

Zugriffstyp: Lesen/Schreiben

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 0 (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: Lesen/Schreiben

Skriptdatentyp: LONG

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

Starttyp

Bestimmt, wie der Dienst gestartet wird. Im Folgenden sind gültige Werte für diese Eigenschaft angegeben.

_ _ ADS-DIENSTSTART _

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-DIENST _ DEAKTIVIERT

Der Dienst kann nicht gestartet werden. Versuche, den Dienst zu starten, führen zum Fehlercode ERROR _ SERVICE _ DISABLED.

Zugriffstyp: Lesen/Schreiben

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: Lesen/Schreiben

Skriptdatentyp: BSTR

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

Version

Version des Diensts.

Zugriffstyp: Lesen/Schreiben

Skriptdatentyp: BSTR

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

Beispiele

Das folgende Codebeispiel zeigt, wie sie alle verfügbaren Systemdienste auflisten, die auf dem Hostcomputer "myMachine" ausgeführt werden, zusammen mit dem Speicherort, an dem die ausführbaren Dateien der Dienste gesucht 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)
Windows Server 2008
Header
Iads.h
DLL
Activeds.dll
IID
IID _ IADsService ist als 68AF66E0-31CA-11CF-A98A-00AA006BC149 definiert.

Weitere Informationen

IADsService

Schnittstelleneigenschaftsmethoden