노드에 설치된 네트워크 인터페이스 또는 그룹을 열거하고 각 호출과 함께 각 의 이름을 반환합니다. PCLUSAPI_CLUSTER_NODE_ENUM 형식은 이 함수에 대한 포인터를 정의합니다.
구문
DWORD ClusterNodeEnum(
[in] HNODEENUM hNodeEnum,
[in] DWORD dwIndex,
[out] LPDWORD lpdwType,
[out] LPWSTR lpszName,
[in, out] LPDWORD lpcchName
);
매개 변수
[in] hNodeEnum
원래 ClusterNodeOpenEnum 함수에서 반환된 기존 열거형 개체에 대한 핸들입니다.
[in] dwIndex
열거할 다음 항목을 식별하는 데 사용되는 인덱스입니다. 이 매개 변수는 ClusterNodeEnum 에 대한 첫 번째 호출에 대해 0이어야 하고 후속 호출에 대해 증가해야 합니다.
[out] lpdwType
반환된 개체의 형식에 대한 포인터입니다. 각 호출과 함께 CLUSTER_NODE_ENUM 열거형의 다음 값이 반환됩니다.
CLUSTER_NODE_ENUM_NETINTERFACES (1)
개체는 네트워크 인터페이스입니다.
CLUSTER_NODE_ENUM_GROUPS(0x00000002)
개체가 클러스터 그룹입니다.
Windows Server 2008: windows Server 2008 R2 이전에는 CLUSTER_NODE_ENUM_GROUPS 값이 지원되지 않습니다.
[out] lpszName
반환된 개체의 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.
[in, out] lpcchName
lpszName 버퍼의 크기를 문자 수로 가리키는 포인터입니다. 입력에서 종료 NULL을 포함하여 버퍼가 보유할 수 있는 최대 문자 수를 지정합니다. 출력에서 종료 되는 NULL을 제외하고 결과 이름의 문자 수를 지정합니다.
반환 값
함수는 다음 값 중 하나를 반환합니다.
| 반환 코드/값 | 설명 |
|---|---|
|
작업이 성공적으로 완료되었습니다. |
|
사용 가능한 데이터가 더 이상 없습니다. 이 값은 반환할 요청된 형식의 개체가 더 이상 없으면 반환됩니다. |
|
추가 데이터를 사용할 수 있습니다. lpszName이 가리키는 버퍼가 결과를 저장할 만큼 크지 않은 경우 이 값이 반환됩니다. lpcchName 매개 변수는 종료되는 NULL을 제외하고 결과의 문자 수를 반환합니다. |
설명
ClusterNodeEnum을 사용하려면 먼저 dwType 매개 변수가 CLUSTER_NODE_ENUM_NETINTERFACES 설정된 ClusterNodeOpenEnum을 호출하여 노드 열거형 핸들을 엽니다. 자세한 내용은 개체 열거를 참조하세요.
lpcchName 매개 변수는 바이트 수가 아닌 문자 수를 나타내며 반환된 크기에는 종료되는 NULL이 개수에 포함되지 않습니다. 버퍼 크기 조정에 대한 자세한 내용은 데이터 크기 규칙을 참조하세요.
예제
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| 대상 플랫폼 | Windows |
| 헤더 | clusapi.h |
| 라이브러리 | ClusAPI.lib |
| DLL | ClusAPI.dll |