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을 제외하고 결과 이름의 문자 수를 나타냅니다.
반환 값
함수는 다음 값 중 하나를 반환합니다.
반환 코드/값 | 설명 |
---|---|
|
작업이 성공적으로 완료되었습니다. |
|
사용 가능한 데이터가 더 이상 없습니다. 반환할 개체가 더 이상 없으면 이 값이 반환됩니다. |
|
추가 데이터를 사용할 수 있습니다. lpszName이 가리키는 버퍼가 결과를 저장할 만큼 크지 않은 경우 이 값이 반환됩니다. lpcchName 매개 변수는 종료되는 NULL을 제외하고 결과의 문자 수를 반환합니다. |
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | 지원되는 버전 없음 |
지원되는 최소 서버 | Windows Server 2016 |
대상 플랫폼 | Windows |
헤더 | clusapi.h |
라이브러리 | ClusAPI.lib |
DLL | ClusAPI.dll |