Функция ResUtilGetEnvironmentWithNetName (resapi.h)
Корректирует данные среды для ресурса таким образом, чтобы ресурс использовал сетевое имя кластера для определения своего расположения. Ресурс должен зависеть от ресурса сетевого имени . Тип PRESUTIL_GET_ENVIRONMENT_WITH_NET_NAME определяет указатель на эту функцию.
Синтаксис
LPVOID ResUtilGetEnvironmentWithNetName(
[in] HRESOURCE hResource
);
Параметры
[in] hResource
Дескриптор ресурса, который зависит от ресурса сетевого имени.
Возвращаемое значение
Если операции выполняются успешно, функция возвращает указатель на блок среды.
Если операция завершается сбоем, функция возвращает значение NULL. Для получения дополнительных сведений вызовите Метод GetLastError.
Комментарии
Функция ResUtilGetEnvironmentWithNetName добавляет переменные среды к текущему блоку среды. Передайте возвращенный блок среды в CreateProcess при запуске ресурса, чтобы добиться следующих результатов:
- Клиенты и кластер могут найти ресурс, используя имя ресурса сетевого имени.
- Если ресурс вызывает GetComputerName, GetComputerNameEx или gethostbyname, сетевое имя будет возвращено независимо от того, на каком узле в данный момент размещен ресурс.
Используйте ResUtilFreeEnvironment , чтобы уничтожить блок среды.
Не вызывайте ResUtilGetEnvironmentWithNetName из любой функции точки входа DLL ресурса. ResUtilGetEnvironmentWithNetName можно безопасно вызывать из рабочего потока. Дополнительные сведения см. в разделе Вызовы функций, которые следует избегать в библиотеках DLL ресурсов.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2008 Корпоративная, Windows Server 2008 Datacenter |
| Целевая платформа | Windows |
| Header | resapi.h |
| Библиотека | ResUtils.lib |
| DLL | ResUtils.dll |