Função ResUtilSetResourceServiceStartParameters (resapi.h)

Ajusta os parâmetros de início de um serviço especificado para que ele opere corretamente como um recurso de cluster. Ele deve ser chamado de uma DLL de recurso. O tipo PRESUTIL_SET_RESOURCE_SERVICE_START_PARAMETERS define um ponteiro para essa função.

Sintaxe

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

Parâmetros

[in] pszServiceName

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo especificando o nome do serviço.

[in] schSCMHandle

Manipule para o SCM (Service Control Manager) ou NULL. Se FOR NULL, a função tentará abrir um identificador para o SCM.

[in, out] phService

Na entrada, um identificador de serviço NULL . Na saída, manipule para o serviço especificado se a chamada tiver sido bem-sucedida, caso contrário, NULL.

[in] pfnLogEvent

Ponteiro para a função de ponto de entrada LogEvent da DLL de recurso que gerencia o serviço.

[in] hResourceHandle

Identificador de recurso exigido pela função de ponto de entrada LogEvent . Use o identificador passado para a DLL na função Abrir ponto de entrada.

Retornar valor

Se a operação for bem-sucedida, a função retornará ERROR_SUCCESS.

Se a operação falhar, a função retornará um código de erro do sistema.

Comentários

ResUtilSetResourceServiceStartParameters verifica se o serviço não está desabilitado, altera a configuração do serviço para início manual e impede que o serviço seja reiniciado em resposta à falha. Isso permite que o cluster e a DLL do recurso controlem o serviço.

Se a DLL de recurso gerenciar um serviço, use ResUtilSetResourceServiceStartParameters e ResUtilSetResourceServiceEnvironment antes de colocar o serviço online.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Plataforma de Destino	Windows
Cabeçalho	resapi.h
Biblioteca	ResUtils.lib
DLL	ResUtils.dll

Confira também

Logevent

Online

Abrir

ResUtilSetResourceServiceEnvironment