구문
DWORD ResUtilSetPrivatePropertyList(
[in] HKEY hkeyClusterKey,
[in] const PVOID pInPropertyList,
[in] DWORD cbInPropertyListSize
);
매개 변수
[in] hkeyClusterKey
설정할 속성의 위치를 식별하는 클러스터 데이터베이스 키입니다.
[in] pInPropertyList
설정할 속성의 이름과 값이 있는 속성 목록이 포함된 입력 버퍼에 대한 포인터입니다.
[in] cbInPropertyListSize
pInPropertyList가 가리키는 입력 버퍼의 크기(바이트)에 대한 포인터입니다.
반환 값
작업이 성공하면 함수는 ERROR_SUCCESS 반환합니다.
작업이 실패하면 함수는 시스템 오류 코드를 반환합니다. 가능한 오류 코드는 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
하나 이상의 입력 매개 변수가 잘못되었습니다. |
|
속성의 데이터 길이에 문제가 있었습니다. |
|
pInPropertyList가 가리키는 입력 버퍼는 NULL입니다. |
|
속성 이름의 구문이 잘못되었습니다. |
설명
ResUtilSetPrivatePropertyList 유틸리티 함수에 설정된 속성은 속성 목록의 이름에 지정된 대로 개체에 대해 지정된 키 아래의 클러스터 데이터베이스 부분에 배치됩니다. 속성 이름에 백슬래시 문자(\)가 포함된 경우 백슬래시 문자 앞의 각 문자열은 하위 키 이름으로 해석되고 마지막 백슬래시 문자 뒤에 오는 마지막 문자열은 값 이름으로 해석됩니다.
다음 리소스 DLL 진입점 함수에서 ResUtilSetPrivatePropertyList 를 호출하지 마세요.
ResUtilSetPrivatePropertyList 는 다른 리소스 DLL 진입점 함수 또는 작업자 스레드에서 안전하게 호출할 수 있습니다. 자세한 내용은 리소스 DLL에서 피해야 할 함수 호출을 참조하세요.요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| 대상 플랫폼 | Windows |
| 헤더 | resapi.h |
| 라이브러리 | ResUtils.lib |
| DLL | ResUtils.dll |