CreateCluster 함수(clusapi.h)
클러스터를 만들고 시작합니다. 클러스터는 지정된 노드 집합으로 구성되며, 네트워크 이름, IP 주소 및 쿼럼 리소스 (지정된 경우)로 구성됩니다. PCLUSAPI_CREATE_CLUSTER 형식은 이 함수에 대한 포인터를 정의합니다.
구문
HCLUSTER CreateCluster(
[in] PCREATE_CLUSTER_CONFIG pConfig,
[in, optional] PCLUSTER_SETUP_PROGRESS_CALLBACK pfnProgressCallback,
[in, optional] PVOID pvCallbackArg
);
매개 변수
[in] pConfig
만들 클러스터에 대한 구성 정보를 포함하는 CREATE_CLUSTER_CONFIG 구조체의 주소입니다.
[in, optional] pfnProgressCallback
클러스터 만들기에 대한 진행률을 제공하기 위해 주기적으로 호출되는 PCLUSTER_SETUP_PROGRESS_CALLBACK 함수 포인터와 일치하는 콜백 함수의 주소입니다.
[in, optional] pvCallbackArg
콜백 함수에 대한 인수입니다.
반환 값
새로 만든 클러스터 또는 NULL에 대한 핸들입니다. NULL이 아닌 값은 완전한 성공을 의미하지는 않습니다(모든 노드가 추가되었지만 모든 IP 주소 또는 네트워크 이름 리소스가 만들어지는 것은 아닙니다.) pfnProgressCallback 매개 변수가 가리키는 함수에 전달된 매개 변수를 확인해야 합니다.
| 반환 코드 | 설명 |
|---|---|
|
대부분의 노드가 성공적으로 생성되었습니다. 오류에 대한 자세한 내용은 GetLastError 함수를 호출합니다. |
설명
PCLUSAPI_CREATE_CLUSTER 형식은 이 함수에 대한 포인터를 정의하며 GetProcAddress 함수와 함께 이 함수를 호출하는 데 사용할 수 있습니다.
CreateCluster 함수가 성공적으로 완료되면 AddClusterNode 함수를 호출하여 노드를 추가하기 전에 최소 30초가 허용되어야 합니다.
클러스터 쿼럼이 달성된 후 CreateCluster 함수가 성공적으로 완료됩니다. 하나 이상의 클러스터 노드가 몇 초 동안 ClusterNodeDown 또는 ClusterNodeJoining 상태일 수 있습니다.
CreateCluster 함수를 호출하기 전에 다음 코드와 같이 dwCoInit 매개 변수에 대한 COINIT_MULTITHREADED 및 COINIT_DISABLE_OLE1DDE 모두 지정하여 CoInitializeEx 함수를 호출해야 합니다.
CoInitializeEx( NULL, COINIT_MULTITHREADED | COINIT_DISABLE_OLE1DDE );
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2008 Datacenter, Windows Server 2008 Enterprise |
| 대상 플랫폼 | Windows |
| 헤더 | clusapi.h |
| 라이브러리 | ClusAPI.lib |
| DLL | ClusAPI.dll |