속성 테이블의 속성 목록을 기반으로 클러스터 데이터베이스의 속성을 설정합니다.
구문
DWORD ResUtilSetPropertyTable(
[in] HKEY hkeyClusterKey,
[in] const PRESUTIL_PROPERTY_ITEM pPropertyTable,
PVOID Reserved,
[in] BOOL bAllowUnknownProperties,
[in] const PVOID pInPropertyList,
[in] DWORD cbInPropertyListSize,
[out, optional] LPBYTE pOutParams
);
매개 변수
[in] hkeyClusterKey
설정할 속성의 위치를 식별하는 클러스터 데이터베이스 키입니다.
[in] pPropertyTable
설정할 속성을 설명하는 RESUTIL_PROPERTY_ITEM 구조체 배열에 대한 포인터입니다.
Reserved
예약되어 있습니다.
[in] bAllowUnknownProperties
알 수 없는 속성을 수락해야 하는지 여부를 나타냅니다. 이 매개 변수는 수락해야 하는 경우 TRUE 로 설정되고, 그렇지 않으면 FALSE 로 설정됩니다.
[in] pInPropertyList
속성 목록을 포함하는 입력 버퍼에 대한 포인터입니다.
[in] cbInPropertyListSize
cbInPropertyList가 가리키는 입력 버퍼의 크기(바이트)입니다.
[out, optional] pOutParams
반환된 데이터를 저장할 매개 변수 블록 에 대한 포인터입니다. 지정된 경우 매개 변수는 입력 버퍼의 매개 변수와 다른 경우에만 작성됩니다.
반환 값
작업이 성공하면 함수는 ERROR_SUCCESS 반환합니다.
작업이 실패하면 함수는 시스템 오류 코드를 반환합니다. 가능한 오류 코드는 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
하나 이상의 입력 매개 변수가 잘못되었습니다. |
|
cbInPropertyListSize에 지정된 입력 버퍼의 크기가 너무 작습니다. |
|
pInPropertyList가 가리키는 입력 버퍼가 NULL이거나, 속성 이름이 유효하지 않거나, 속성 값이 너무 작습니다. |
|
pPropertyTable이 가리키는 속성 테이블의 속성 구문, 형식 또는 형식이 올바르지 않거나 속성이 읽기 전용이므로 설정할 수 없습니다. |
설명
속성 테이블에 지정된 값이 클러스터 데이터베이스에 이미 있는 경우 값이 기록되지 않습니다. 모든 값을 강제로 작성하도록 하는 방법에 대한 자세한 내용은 ResUtilSetPropertyTableEx를 참조하세요.
다음 리소스 DLL 진입점 함수에서 ResUtilSetPropertyTable 을 호출하지 마세요.
ResUtilSetPropertyTable 은 다른 리소스 DLL 진입점 함수 또는 작업자 스레드에서 안전하게 호출할 수 있습니다. 자세한 내용은 리소스 DLL에서 피해야 할 함수 호출을 참조하세요.요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| 대상 플랫폼 | Windows |
| 헤더 | resapi.h |
| 라이브러리 | ResUtils.lib |
| DLL | ResUtils.dll |