ResUtilGetEnvironmentWithNetName 함수(resapi.h)
리소스가 클러스터 네트워크 이름을 사용하여 위치를 식별하도록 리소스 에 대한 환경 데이터를 조정합니다. 리소스는 네트워크 이름 리소스에 종속되어야 합니다. PRESUTIL_GET_ENVIRONMENT_WITH_NET_NAME 형식은 이 함수에 대한 포인터를 정의합니다.
구문
LPVOID ResUtilGetEnvironmentWithNetName(
[in] HRESOURCE hResource
);
매개 변수
[in] hResource
네트워크 이름 리소스에 의존하는 리소스에 대한 핸들입니다.
반환 값
작업이 성공하면 함수는 환경 블록에 대한 포인터를 반환합니다.
작업이 실패하면 함수는 NULL을 반환합니다. 자세한 내용은 GetLastError를 호출합니다.
설명
ResUtilGetEnvironmentWithNetName 함수는 환경 변수를 현재 환경 블록에 추가합니다. 다음 효과를 얻기 위해 리소스를 시작할 때 반환된 환경 블록을 CreateProcess 에 전달합니다.
- 클라이언트와 클러스터 는 네트워크 이름 리소스의 이름을 사용하여 리소스를 찾을 수 있습니다.
- 리소스가 GetComputerName, GetComputerNameEx 또는 gethostbyname을 호출하는 경우 현재 리소스를 호스팅하는 노드에 관계없이 네트워크 이름이 반환됩니다.
ResUtilFreeEnvironment를 사용하여 환경 블록을 삭제합니다.
리소스 DLL 진입점 함수에서 ResUtilGetEnvironmentWithNetName 을 호출하지 마세요. ResUtilGetEnvironmentWithNetName 은 작업자 스레드에서 안전하게 호출할 수 있습니다. 자세한 내용은 리소스 DLL에서 피해야 할 함수 호출을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| 대상 플랫폼 | Windows |
| 헤더 | resapi.h |
| 라이브러리 | ResUtils.lib |
| DLL | ResUtils.dll |