다음을 통해 공유

ClusterControl 함수(clusapi.h)

  • 아티클

클러스터에 영향을 주는 작업을 시작합니다. 수행되는 작업은 dwControlCode 매개 변수에 전달된 제어 코드에 따라 달라집니다.

구문

DWORD ClusterControl(
  [in]            HCLUSTER hCluster,
  [in, optional]  HNODE    hHostNode,
  [in]            DWORD    dwControlCode,
  [in, optional]  LPVOID   lpInBuffer,
  [in]            DWORD    nInBufferSize,
  [out, optional] LPVOID   lpOutBuffer,
  [in]            DWORD    nOutBufferSize,
  [out, optional] LPDWORD  lpBytesReturned
);

매개 변수

[in] hCluster

영향을 받을 클러스터에 대한 핸들입니다.

[in, optional] hHostNode

NULL이 아닌 경우 를 노드에 핸들로 처리하여 컨트롤 코드로 표시되는 작업을 수행합니다. NULL이면 로컬 노드가 작업을 수행합니다. hHostNode 지정은 선택 사항입니다.

[in] dwControlCode

수행할 작업을 지정하는 CLUSCTL_CLUSTER_CODES 열거형의 클러스터 제어 코드입니다. 컨트롤 코드와 연결된 구문은 제어 코드 아키텍처 및 다음 topics 참조하세요.

[in, optional] lpInBuffer

작업에 필요한 정보를 포함하는 입력 버퍼에 대한 포인터이거나 정보가 필요하지 않은 경우 NULL 입니다.

[in] nInBufferSize

입력 버퍼의 할당된 크기(바이트)입니다.

[out, optional] lpOutBuffer

작업에서 생성된 데이터를 수신할 출력 버퍼에 대한 포인터이거나, 반환되는 데이터가 없는 경우 NULL 입니다.

[in] nOutBufferSize

출력 버퍼의 할당된 크기(바이트)입니다.

[out, optional] lpBytesReturned

작업으로 인한 데이터의 실제 크기(바이트)를 반환합니다. 이 정보가 필요하지 않은 경우 lpcbBytesReturned에 대해 NULL을 전달합니다.

반환 값

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

반환 코드 설명
ERROR_SUCCESS
 작업이 완료되었습니다. 작업에 출력 버퍼가 필요한 경우 lpcbBytesReturned (입력 시 NULL 이 아닌 경우)은 버퍼에 반환된 데이터의 실제 크기를 가리킵니다.
ERROR_MORE_DATA
 lpOutBuffer가 가리키는 출력 버퍼가 작업으로 인한 데이터를 저장할 만큼 크지 않았습니다. lpcbBytesReturned 매개 변수(입력 시 NULL이 아닌 경우)는 출력 버퍼에 필요한 크기를 가리킵니다. 출력 버퍼가 필요한 작업만 ERROR_MORE_DATA. lpOutBuffer 매개 변수가 NULL이고 nOutBufferSize 매개 변수가 0이면 ERROR_MORE_DATA 아니라 ERROR_SUCCESS 반환될 수 있습니다.
시스템 오류 코드
 작업이 성공하지 못했습니다. 작업에 출력 버퍼가 필요한 경우 lpcbBytesReturned (입력 시 NULL 이 아닌 경우)으로 지정된 값은 신뢰할 수 없습니다.

설명

ClusterControl이ERROR_MORE_DATA 반환하는 경우 nOutBufferSize를 lpcbBytesReturned이 가리키는 바이트 수로 설정하고 함수를 다시 호출합니다.

LPC 및 RPC 핸들을 동일한 함수 호출에 전달하지 마세요. 그렇지 않으면 호출이 RPC 예외를 발생시키고 추가적인 파괴적인 영향을 미칠 수 있습니다. LPC 및 RPC 핸들을 만드는 방법에 대한 자세한 내용은 LPC 및 RPC 핸들 및 OpenCluster를 참조하세요.

ClusterControl 은 제어 코드 함수 중 하나입니다. 제어 코드 및 제어 코드 함수에 대한 자세한 내용은 제어 코드 사용을 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 지원되는 버전 없음
지원되는 최소 서버 Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
대상 플랫폼 Windows
헤더 clusapi.h
라이브러리 ClusAPI.lib
DLL ClusAPI.dll

추가 정보

클러스터 제어 코드

OpenCluster