Función ResUtilGetEnvironmentWithNetName (resapi.h)

Ajusta los datos de entorno de un recurso para que el recurso use un nombre de red de clúster para identificar su ubicación. El recurso debe depender de un recurso nombre de red . El tipo PRESUTIL_GET_ENVIRONMENT_WITH_NET_NAME define un puntero a esta función.

Sintaxis

LPVOID ResUtilGetEnvironmentWithNetName(
  [in] HRESOURCE hResource
);

Parámetros

[in] hResource

Identificador de un recurso que depende de un recurso de nombre de red.

Valor devuelto

Si las operaciones se realizan correctamente, la función devuelve un puntero al bloque de entorno.

Si se produce un error en la operación, la función devuelve NULL. Para obtener más información, llame a GetLastError.

Comentarios

La función ResUtilGetEnvironmentWithNetName anexa variables de entorno al bloque de entorno actual. Pase el bloque de entorno devuelto a CreateProcess al iniciar el recurso para lograr los siguientes efectos:

• Los clientes y el clúster pueden localizar el recurso mediante el nombre del recurso Nombre de red.
• Si el recurso llama a GetComputerName, GetComputerNameEx o gethostbyname, el nombre de red se devolverá independientemente del nodo que hospeda actualmente el recurso.

Si el recurso identificado por hResource no depende de un recurso nombre de red, ResUtilGetEnvironmentWithNetName devuelve NULL.

Use ResUtilFreeEnvironment para destruir el bloque de entorno.

No llame a ResUtilGetEnvironmentWithNetName desde cualquier función de punto de entrada dll de recurso. Se puede llamar a ResUtilGetEnvironmentWithNetName de forma segura desde un subproceso de trabajo. Para obtener más información, consulte Llamadas de función para evitar en archivos DLL de recursos.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Plataforma de destino	Windows
Encabezado	resapi.h
Library	ResUtils.lib
Archivo DLL	ResUtils.dll

Consulte también

ResUtilSetResourceServiceEnvironment