클러스터의 네트워크에 대한 노드 인터페이스의 이름을 반환합니다. PCLUSAPI_GET_CLUSTER_NET_INTERFACE 형식은 이 함수에 대한 포인터를 정의합니다.
구문
DWORD GetClusterNetInterface(
[in] HCLUSTER hCluster,
[in] LPCWSTR lpszNodeName,
[in] LPCWSTR lpszNetworkName,
[out] LPWSTR lpszInterfaceName,
[in, out] LPDWORD lpcchInterfaceName
);
매개 변수
[in] hCluster
클러스터에 대한 핸들입니다.
[in] lpszNodeName
클러스터의 노드 이름을 포함하는 null로 종료된 유니코드 문자열에 대한 포인터입니다.
[in] lpszNetworkName
네트워크 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.
[out] lpszInterfaceName
네트워크 인터페이스의 이름을 포함하는 출력 버퍼에 대한 포인터입니다.
[in, out] lpcchInterfaceName
문자 수로 lpszInterfaceName 버퍼의 크기에 대한 포인터입니다. 입력에서 종료 NULL을 포함하여 버퍼가 보유할 수 있는 최대 문자 수를 지정합니다. 출력에서 종료 되는 NULL을 제외하고 결과 이름의 문자 수를 지정합니다.
반환 값
작업이 성공하면 함수는 ERROR_SUCCESS 반환합니다.
작업이 실패하면 함수는 시스템 오류 코드를 반환합니다. 다음은 가능한 값 중 하나입니다.
| 반환 코드 | 설명 |
|---|---|
|
lpszInterfaceName이 가리키는 버퍼는 결과를 저장할 만큼 크지 않습니다. lpcchInterfaceName 매개 변수는 종료되는 NULL을 제외하고 결과의 문자 수를 반환합니다. |
설명
lpcchInterfaceName은 바이트 수가 아닌 문자 수를 나타내며 반환된 크기에는 종료되는 NULL이 개수에 포함되지 않습니다. 버퍼 크기 조정에 대한 자세한 내용은 데이터 크기 규칙을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
| 대상 플랫폼 | Windows |
| 헤더 | clusapi.h |
| 라이브러리 | ClusAPI.lib |
| DLL | ClusAPI.dll |