Compartilhar via

Função ResUtilGetEnvironmentWithNetName (resapi.h)

  • Artigo

Ajusta os dados de ambiente de um recurso para que o recurso use um nome de rede de cluster para identificar sua localização. O recurso deve depender de um recurso de Nome de Rede . O tipo PRESUTIL_GET_ENVIRONMENT_WITH_NET_NAME define um ponteiro para essa função.

Sintaxe

LPVOID ResUtilGetEnvironmentWithNetName(
  [in] HRESOURCE hResource
);

Parâmetros

[in] hResource

Manipule para um recurso que depende de um recurso de Nome de Rede.

Retornar valor

Se as operações forem bem-sucedidas, a função retornará um ponteiro para o bloco de ambiente.

Se a operação falhar, a função retornará NULL. Para obter mais informações, chame GetLastError.

Comentários

A função ResUtilGetEnvironmentWithNetName acrescenta variáveis de ambiente ao bloco de ambiente atual. Passe o bloco de ambiente retornado para CreateProcess ao iniciar o recurso para obter os seguintes efeitos:

  • Os clientes e o cluster podem localizar o recurso usando o nome do recurso Nome da Rede.
  • Se o recurso chamar GetComputerName, GetComputerNameEx ou gethostbyname, o nome da rede será retornado independentemente de qual nó está hospedando o recurso no momento.
Se o recurso identificado por hResource não depender de um recurso de Nome de Rede, ResUtilGetEnvironmentWithNetName retornará NULL.

Use ResUtilFreeEnvironment para destruir o bloco de ambiente.

Não chame ResUtilGetEnvironmentWithNetName de nenhuma função de ponto de entrada de DLL de recurso. ResUtilGetEnvironmentWithNetName 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

ResUtilSetResourceServiceEnvironment