ICOMAdminCatalog2::CreateServiceForApplication-Methode (comadmin.h)

Artikel
08/22/2023

Konfiguriert eine COM+-Anwendung für die Ausführung als Windows-Dienst.

Syntax

HRESULT CreateServiceForApplication(
  [in] BSTR         bstrApplicationIDOrName,
  [in] BSTR         bstrServiceName,
  [in] BSTR         bstrStartType,
  [in] BSTR         bstrErrorControl,
  [in] BSTR         bstrDependencies,
  [in] BSTR         bstrRunAs,
  [in] BSTR         bstrPassword,
  [in] VARIANT_BOOL bDesktopOk
);

Parameter

[in] bstrApplicationIDOrName

Die Anwendungs-ID oder der Name der Anwendung.

[in] bstrServiceName

Der Dienstname der Anwendung. Dieser Name ist der interne Name, der vom Dienststeuerungs-Manager (SCM) verwendet wird, nicht der Anzeigename.

[in] bstrStartType

Wann der Dienst gestartet werden soll. Die gültigen Argumente sind die Optionen des dwStartType-Parameters der CreateService-Funktion . Die Argumente müssen in Anführungszeichen enthalten sein. Die folgenden Argumente sind gültig: SERVICE_BOOT_START, SERVICE_SYSTEM_START, SERVICE_AUTO_START, SERVICE_DEMAND_START und SERVICE_DISABLED.

[in] bstrErrorControl

Der Schweregrad des Fehlers, wenn dieser Dienst während des Starts nicht gestartet werden kann. Der Fehler bestimmt die Aktion, die vom Startprogramm ausgeführt wird, wenn ein Fehler auftritt. Die gültigen Argumente sind die Optionen des dwErrorControl-Parameters der CreateService-Funktion . Die Argumente müssen in Anführungszeichen enthalten sein. Die folgenden Argumente sind gültig: SERVICE_ERROR_IGNORE, SERVICE_ERROR_NORMAL, SERVICE_ERROR_SEVERE und SERVICE_ERROR_CRITICAL.

[in] bstrDependencies

Eine Liste der Abhängigkeiten für den Dienst. Es gibt zwei mögliche Formate für die Zeichenfolge: eine standardmäßige, durch NULL getrennte, double-NULL-endende Zeichenfolge (genau wie für CreateService dokumentiert); oder eine skriptfreundliche Liste von Dienstnamen, die durch "" getrennt sind (ein ungültiges Zeichen, das in einem Dienstnamen enthalten sein muss). Der rpcss-Dienst ist in diesem Parameter implizit und muss nicht angegeben werden.

[in] bstrRunAs

Der Benutzername, unter dem dieser Dienst ausgeführt werden soll. Wenn dieser Parameter NULL ist, wird der Dienst als lokaler Dienst ausgeführt.

[in] bstrPassword

Das Kennwort für das Systembenutzerkonto. Dieser Parameter muss NULL sein, wenn der Dienst für die Ausführung als lokaler Dienst konfiguriert ist.

[in] bDesktopOk

Gibt an, ob der Dienst mit dem Desktop interagieren darf. Dieser Parameter ist nur gültig, wenn der Dienst als lokaler Dienst gekennzeichnet ist und andernfalls FALSE sein muss.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL und S_OK zurückgeben.

Hinweise

Ein mit dieser Methode erstellter Dienst kann mithilfe der DeleteServiceForApplication-Methode entfernt werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	comadmin.h

Weitere Informationen

ICOMAdminCatalog2

Freigeben über