ResUtilSetResourceServiceEnvironment 함수(resapi.h)
서비스에서 클러스터 네트워크 이름을 사용하여 해당 위치를 식별하도록 서비스에 대한 환경 데이터를 조정합니다. 이 함수는 리소스 DLL에서 호출해야 합니다. PRESUTIL_SET_RESOURCE_SERVICE_ENVIRONMENT 형식은 이 함수에 대한 포인터를 정의합니다.
구문
DWORD ResUtilSetResourceServiceEnvironment(
[in] LPCWSTR pszServiceName,
[in] HRESOURCE hResource,
[in] PLOG_EVENT_ROUTINE pfnLogEvent,
[in] RESOURCE_HANDLE hResourceHandle
);
매개 변수
[in] pszServiceName
서비스 이름을 포함하는 null로 끝나는 유니코드 문자열을 가리키는 포인터입니다.
[in] hResource
OpenClusterResource에서 가져온 서비스에 대한 리소스 핸들입니다.
[in] pfnLogEvent
서비스를 관리하는 리소스 DLL의 LogEvent 진입점 함수에 대한 포인터입니다.
[in] hResourceHandle
LogEvent 진입점 함수에 필요한 리소스 핸들입니다. Open 진입점 함수에서 DLL에 전달된 핸들을 사용합니다.
반환 값
작업이 성공하면 함수는 ERROR_SUCCESS 반환합니다.
작업이 실패하면 함수는 시스템 오류 코드를 반환합니다.
설명
ResUtilSetResourceServiceEnvironment 는 ResUtilGetEnvironmentWithNetName 을 호출하고 결과 환경 블록을 서비스의 레지스트리 항목에 저장합니다. 환경 블록의 효과에 대한 자세한 내용은 ResUtilGetEnvironmentWithNetName을 참조하세요.
리소스 DLL이 서비스를 관리하는 경우 작업자 스레드를 만들고 서비스를 온라인 상태로 만들 때 ResUtilSetResourceServiceStartParameters 및 ResUtilSetResourceServiceEnvironment 를 사용합니다.
리소스 DLL 진입점 함수에서 ResUtilSetResourceServiceEnvironment 를 호출하지 마세요. ResUtilSetResourceServiceEnvironment 는 작업자 스레드에서 안전하게 호출할 수 있습니다. 자세한 내용은 리소스 DLL에서 피해야 할 함수 호출을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| 대상 플랫폼 | Windows |
| 헤더 | resapi.h |
| 라이브러리 | ResUtils.lib |
| DLL | ResUtils.dll |