Metodo ICOMAdminCatalog2::CreateServiceForApplication (comadmin.h)

  • Articolo

Configura un'applicazione COM+ da eseguire come servizio Windows.

Sintassi

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
);

Parametri

[in] bstrApplicationIDOrName

ID applicazione o nome dell'applicazione.

[in] bstrServiceName

Nome del servizio dell'applicazione. Questo nome è il nome interno utilizzato dal gestore di controllo del servizio (SCM), non il nome visualizzato.

[in] bstrStartType

Quando avviare il servizio. Gli argomenti validi sono le opzioni del parametro dwStartType della funzione CreateService . Gli argomenti devono essere in virgolette. Di seguito sono riportati gli argomenti validi: SERVICE_BOOT_START, SERVICE_SYSTEM_START, SERVICE_AUTO_START, SERVICE_DEMAND_START e SERVICE_DISABLED.

[in] bstrErrorControl

Gravità dell'errore se questo servizio non viene avviato durante l'avvio. L'errore determina l'azione eseguita dal programma di avvio se si verifica un errore. Gli argomenti validi sono le opzioni del parametro dwErrorControl della funzione CreateService . Gli argomenti devono essere in virgolette. Di seguito sono riportati gli argomenti validi: SERVICE_ERROR_IGNORE, SERVICE_ERROR_NORMAL, SERVICE_ERROR_SEVERE e SERVICE_ERROR_CRITICAL.

[in] bstrDependencies

Elenco delle dipendenze per il servizio. Esistono due formati possibili per la stringa: una stringa delimitata da null standard e con terminazione null doppia (esattamente come documentata per CreateService); o un elenco descrittivo di nomi di servizio separati da "" (un carattere non valido da avere in un nome del servizio). Il servizio rpcss è implicito in questo parametro e non deve essere specificato.

[in] bstrRunAs

Nome utente da eseguire come servizio. Se questo parametro è NULL, il servizio verrà eseguito come servizio locale.

[in] bstrPassword

Password per l'account utente di sistema. Questo parametro deve essere NULL se il servizio è configurato per l'esecuzione come servizio locale.

[in] bDesktopOk

Indica se il servizio deve essere autorizzato a interagire con il desktop. Questo parametro è valido solo quando il servizio è contrassegnato come servizio locale e deve essere FALSE in caso contrario.

Valore restituito

Questo metodo può restituire i valori restituiti standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL e S_OK.

Commenti

Un servizio creato da questo metodo può essere rimosso usando il metodo DeleteServiceForApplication .

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione comadmin.h

Vedi anche

ICOMAdminCatalog2