클러스터 데이터베이스 키의 값을 설정합니다.
구문
DWORD ClusterRegSetValue(
[in] HKEY hKey,
[in] LPCWSTR lpszValueName,
[in] DWORD dwType,
[in] const BYTE *lpData,
[in] DWORD cbData
);
매개 변수
[in] hKey
클러스터 데이터베이스 키에 대한 핸들입니다.
[in] lpszValueName
설정할 값의 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 이 이름의 값이 리소스에 아직 없는 경우 ClusterRegSetValue 는 해당 값을 리소스에 추가합니다.
[in] dwType
값의 데이터로 저장할 정보 유형입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다. 자세한 내용은 레지스트리 값 형식을 참조하세요.
REG_BINARY (3)
모든 형태의 이진 데이터입니다.
REG_DWORD (4)
32비트 숫자입니다.
REG_DWORD_BIG_ENDIAN (5)
big-endian 형식으로 저장된 32비트 숫자입니다.
REG_EXPAND_SZ (2)
환경 변수에 대한 확장되지 않은 참조(예: "%PATH%")를 포함하는 null로 끝나는 유니코드 문자열입니다.
REG_MULTI_SZ (6)
빈 문자열(\0)에 의해 종료되는 null로 끝나는 문자열의 시퀀스입니다.
다음은 이에 대한 예입니다.
String1\0String2\0String3\0LastString\0\0
첫 번째 \0은 첫 번째 문자열을 종료하고, 마지막 \0의 두 번째 문자열은 마지막 문자열을 종료하고, 마지막 \0은 시퀀스를 종료합니다. 마지막 종결자는 문자열의 길이로 계산되어야 합니다.
REG_NONE (0)
정의된 값 형식이 없습니다.
REG_QWORD (11)
64비트 숫자입니다.
REG_SZ (1)
null로 끝나는 유니코드 문자열입니다.
[in] lpData
lpszValueName에서 가리키는 이름으로 저장할 데이터에 대한 포인터입니다.
[in] cbData
lpbData 매개 변수가 가리키는 데이터의 바이트 수입니다. 데이터가 형식이 REG_SZ, REG_EXPAND_SZ 또는 REG_MULTI_SZ 경우 cbData 는 null 종료 문자의 크기를 포함해야 합니다.
반환 값
작업이 성공하면 함수는 ERROR_SUCCESS 반환합니다.
작업이 실패하면 함수는 시스템 오류 코드를 반환합니다.
설명
다음 리소스 DLL 진입점 함수에서 ClusterRegSetValue 를 호출하지 마세요.
ClusterRegSetValue 는 다른 리소스 DLL 진입점 함수 또는 작업자 스레드에서 안전하게 호출할 수 있습니다. 자세한 내용은 리소스 DLL에서 피해야 할 함수 호출을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| 대상 플랫폼 | Windows |
| 헤더 | clusapi.h |
| 라이브러리 | ClusAPI.lib |
| DLL | ClusAPI.dll |