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.
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 |