다음을 통해 공유


ClusterNetInterfaceEnum 함수(clusapi.h)

클러스터에 설치된 네트워크 인터페이스를 열거하고 각 호출과 함께 하나의 이름을 반환합니다.

구문

DWORD ClusterNetInterfaceEnum(
  [in]      HNETINTERFACEENUM hNetInterfaceEnum,
  [in]      DWORD             dwIndex,
  [out]     LPWSTR            lpszName,
  [in, out] LPDWORD           lpcchName
);

매개 변수

[in] hNetInterfaceEnum

원래 ClusterNetInterfaceOpenEnum 함수에서 반환된 기존 열거형 개체에 대한 핸들입니다.

[in] dwIndex

열거할 항목을 식별하는 데 사용되는 인덱스입니다. 이 매개 변수는 첫 번째 호출에 대해 0이어야 하며 이후 각 호출에 대해 증가해야 합니다.

[out] lpszName

반환된 개체의 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

[in, out] lpcchName

lpszName 버퍼의 크기(문자)에 대한 포인터입니다. 입력에서 종료 NULL을 포함하여 버퍼가 보유할 수 있는 최대 문자 수를 지정합니다. 출력에서 은 종료 되는 NULL을 제외하고 결과 이름의 문자 수를 나타냅니다.

반환 값

함수는 다음 값 중 하나를 반환합니다.

반환 코드/값 설명
ERROR_SUCCESS
0
작업이 성공적으로 완료되었습니다.
ERROR_NO_MORE_ITEMS
259(0x103)
사용 가능한 데이터가 더 이상 없습니다. 반환할 개체가 더 이상 없으면 이 값이 반환됩니다.
ERROR_MORE_DATA
234(0xEA)
추가 데이터를 사용할 수 있습니다. lpszName이 가리키는 버퍼가 결과를 저장할 만큼 크지 않은 경우 이 값이 반환됩니다. lpcchName 매개 변수는 종료되는 NULL을 제외하고 결과의 문자 수를 반환합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 지원되는 버전 없음
지원되는 최소 서버 Windows Server 2016
대상 플랫폼 Windows
헤더 clusapi.h
라이브러리 ClusAPI.lib
DLL ClusAPI.dll