클러스터 데이터베이스에서 문자열 값을 설정합니다. PRESUTIL_SET_SZ_VALUE 형식은 이 함수에 대한 포인터를 정의합니다.
구문
DWORD ResUtilSetSzValue(
[in] HKEY hkeyClusterKey,
[in] LPCWSTR pszValueName,
[in] LPCWSTR pszNewValue,
[in, out, optional] LPWSTR *ppszOutString
);
매개 변수
[in] hkeyClusterKey
클러스터 데이터베이스에서 문자열 값의 위치를 식별하는 키입니다.
[in] pszValueName
업데이트할 값의 이름을 포함하는 Null로 종료된 유니코드 문자열입니다.
[in] pszNewValue
새 문자열 값에 대한 포인터입니다.
[in, out, optional] ppszOutString
업데이트된 값의 복사본을 받는 문자열 포인터에 대한 포인터입니다. 사용하는 경우 호출자는 *ppszOutValue에서 LocalFree를 호출해야 합니다.
반환 값
작업이 성공하면 함수는 ERROR_SUCCESS 반환합니다.
작업이 실패하면 함수는 시스템 오류 코드를 반환합니다. 다음은 가능한 오류 코드입니다.
| 반환 코드 | 설명 |
|---|---|
|
메모리 할당을 시도하는 동안 오류가 발생했습니다. |
설명
ResUtilSetSzValue 유틸리티 함수는 새 값에 대한 메모리를 할당하고 Cluster API 함수 ClusterRegSetValue를 호출합니다. 필요한 경우 이전 값의 할당이 취소됩니다. 새 값이 ppszOutValue의 콘텐츠에 복사됩니다.
메모리 누수 방지를 위해 *ppszOutValue에서 LocalFree를 호출해야 합니다.
다음 리소스 DLL 진입점 함수에서 ResUtilSetSzValue 를 호출하지 마세요.
ResUtilSetSzValue 는 다른 리소스 DLL 진입점 함수 또는 작업자 스레드에서 안전하게 호출할 수 있습니다. 자세한 내용은 리소스 DLL에서 피해야 할 함수 호출을 참조하세요.요구 사항
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| 대상 플랫폼 | Windows |
| 헤더 | resapi.h |
| 라이브러리 | ResUtils.lib |
| DLL | ResUtils.dll |