Funzione ResUtilSetResourceServiceStartParameters (resapi.h)

Articolo
03/01/2024

Regola i parametri di avvio di un servizio specificato in modo che funzioni correttamente come risorsa cluster. Deve essere chiamato da una DLL di risorse. Il tipo PRESUTIL_SET_RESOURCE_SERVICE_START_PARAMETERS definisce un puntatore a questa funzione.

Sintassi

DWORD ResUtilSetResourceServiceStartParameters(
  [in]      LPCWSTR            pszServiceName,
  [in]      SC_HANDLE          schSCMHandle,
  [in, out] LPSC_HANDLE        phService,
  [in]      PLOG_EVENT_ROUTINE pfnLogEvent,
  [in]      RESOURCE_HANDLE    hResourceHandle
);

Parametri

[in] pszServiceName

Puntatore a una stringa Unicode con terminazione Null che specifica il nome del servizio.

[in] schSCMHandle

Gestire in Service Control Manager (SCM) o NULL. Se NULL, la funzione tenterà di aprire un handle per SCM.

[in, out] phService

In input, un handle di servizio NULL . Nell'output, gestire al servizio specificato se la chiamata ha avuto esito positivo; in caso contrario, NULL.

[in] pfnLogEvent

Puntatore alla funzione del punto di ingresso LogEvent della DLL della risorsa che gestisce il servizio.

[in] hResourceHandle

Handle di risorsa richiesto dalla funzione del punto di ingresso LogEvent . Usare l'handle passato alla DLL nella funzione Punto di ingresso Aperto.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce ERROR_SUCCESS.

Se l'operazione non riesce, la funzione restituisce un codice di errore di sistema.

Commenti

ResUtilSetResourceServiceStartParameters verifica che il servizio non sia disabilitato, modifica la configurazione del servizio all'avvio manuale e impedisce il riavvio del servizio in risposta a un errore. In questo modo il cluster e la DLL della risorsa possono controllare il servizio.

Se la DLL della risorsa gestisce un servizio, usare ResUtilSetResourceServiceStartParameters e ResUtilSetResourceServiceEnvironment prima di portare il servizio online.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Piattaforma di destinazione	Windows
Intestazione	resapi.h
Libreria	ResUtils.lib
DLL	ResUtils.dll

Vedi anche

Logevent

Online

Apri

ResUtilSetResourceServiceEnvironment

Condividi tramite