리소스의 종속 리소스, 노드 또는 둘 다를 열거합니다. 호출마다 하나의 클러스터 개체 의 이름을 반환합니다. PCLUSAPI_CLUSTER_RESOURCE_ENUM 형식은 이 함수에 대한 포인터를 정의합니다.
구문
DWORD ClusterResourceEnum(
[in] HRESENUM hResEnum,
[in] DWORD dwIndex,
[out] LPDWORD lpdwType,
[out] LPWSTR lpszName,
[in, out] LPDWORD lpcchName
);
매개 변수
[in] hResEnum
ClusterResourceOpenEnum 함수에서 반환된 리소스 열거형 핸들입니다.
[in] dwIndex
반환할 리소스 또는 노드 개체의 인덱스입니다. 이 매개 변수는 ClusterResourceEnum 함수에 대한 첫 번째 호출에 대해 0이어야 하고 후속 호출에 대해 증가해야 합니다.
[out] lpdwType
ClusterResourceEnum에서 반환된 개체의 형식입니다.
가능한 값은 다음 CLUSTER_RESOURCE_ENUM 열거형 값 중 하나입니다.
CLUSTER_RESOURCE_ENUM_DEPENDS (1)
개체는 리소스이고 hResEnum 은 이 개체에 종속된 리소스입니다.
CLUSTER_RESOURCE_ENUM_PROVIDES (2)
개체는 hResEnum으로 식별되는 리소스에 따라 달라지는 리소스입니다.
CLUSTER_RESOURCE_ENUM_NODES (4)
개체는 hResEnum으로 식별된 리소스를 호스트할 수 있는 노드입니다.
[out] lpszName
반환된 개체의 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.
[in, out] lpcchName
문자 수로 lpszName 버퍼의 크기에 대한 포인터입니다. 입력에서 종료 null 문자를 포함하여 버퍼가 보유할 수 있는 최대 문자 수를 지정합니다. 출력에서 종료되는 null 문자를 제외하고 결과 이름의 문자 수를 지정합니다.
반환 값
함수는 다음 값 중 하나를 반환합니다.
| 반환 코드/값 | 설명 |
|---|---|
|
작업이 성공적으로 완료되거나 lpszName 매개 변수가 NULL입니다. |
|
lpszName 매개 변수가 가리키는 버퍼가 결과를 저장할 만큼 크지 않습니다. lpcchName 매개 변수는 종료 null 문자를 제외하고 결과의 문자 수를 반환합니다. |
|
반환할 개체가 더 이상 없습니다. |
| 반환된 다른 오류 코드는 작업이 실패했음을 나타냅니다. |
설명
lpcchName은 바이트 수가 아닌 문자 수를 나타내며 반환된 크기에는 종료 null 문자가 개수에 포함되지 않습니다. 버퍼 크기 조정에 대한 자세한 내용은 데이터 크기 규칙을 참조하세요.
리소스 DLL 진입점 함수에서 ClusterResourceEnum 을 호출하지 마세요. ClusterResourceEnum 은 작업자 스레드에서 안전하게 호출할 수 있습니다. 자세한 내용은 리소스 DLL에서 피해야 할 함수 호출을 참조하세요.
예제
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| 대상 플랫폼 | Windows |
| 헤더 | clusapi.h |
| 라이브러리 | ClusAPI.lib |
| DLL | ClusAPI.dll |