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 |