Compartilhar via

Função ResUtilSetResourceServiceEnvironment (resapi.h)

  • Artigo

Ajusta os dados de ambiente de um serviço para que o serviço use um nome de rede de cluster para identificar sua localização. Essa função deve ser chamada de uma DLL de recurso. O tipo PRESUTIL_SET_RESOURCE_SERVICE_ENVIRONMENT define um ponteiro para essa função.

Sintaxe

DWORD ResUtilSetResourceServiceEnvironment(
  [in] LPCWSTR            pszServiceName,
  [in] HRESOURCE          hResource,
  [in] PLOG_EVENT_ROUTINE pfnLogEvent,
  [in] RESOURCE_HANDLE    hResourceHandle
);

Parâmetros

[in] pszServiceName

Ponteiro uma cadeia de caracteres Unicode terminada em nulo que contém o nome do serviço.

[in] hResource

Identificador de recurso para o serviço obtido de OpenClusterResource.

[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

ResUtilSetResourceServiceEnvironment chama ResUtilGetEnvironmentWithNetName e armazena o bloco de ambiente resultante em uma entrada de registro para o serviço. Para obter mais informações sobre os efeitos do bloco de ambiente, consulte ResUtilGetEnvironmentWithNetName.

Se a DLL de recurso gerenciar um serviço, crie um thread de trabalho e use ResUtilSetResourceServiceStartParameters e ResUtilSetResourceServiceEnvironment ao colocar o serviço online.

Não chame ResUtilSetResourceServiceEnvironment de nenhuma função de ponto de entrada de DLL de recurso. ResUtilSetResourceServiceEnvironment pode ser chamado com segurança de um thread de trabalho. Para obter mais informações, consulte Chamadas de função a serem evitadas em DLLs de recurso.

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

ResUtilGetEnvironmentWithNetName