다음을 통해 공유

ClusterGroupSetControl 함수(clusapi.h)

그룹 집합에 영향을 주는 작업을 시작합니다.

수행되는 작업은 dwControlCode 매개 변수에 전달된 제어 코드에 따라 달라집니다.

구문

DWORD ClusterGroupSetControl(
  [in]            HGROUPSET hGroupSet,
  [in, optional]  HNODE     hHostNode,
  [in]            DWORD     dwControlCode,
  [in, optional]  LPVOID    lpInBuffer,
  [in]            DWORD     cbInBufferSize,
  [out, optional] LPVOID    lpOutBuffer,
  [in]            DWORD     cbOutBufferSize,
  [out, optional] LPDWORD   lpBytesReturned
);

매개 변수

[in] hGroupSet

영향을 받을 그룹 집합에 대한 핸들입니다.

[in, optional] hHostNode

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

[in] dwControlCode

수행할 작업을 지정하는 컬렉션 제어 코드 입니다. 제어 코드와 연결된 구문은 을 참조하세요.
제어 코드 아키텍처 및 다음 topics.

[in, optional] lpInBuffer

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

[in] cbInBufferSize

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

[out, optional] lpOutBuffer

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

[in] cbOutBufferSize

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

[out, optional] lpBytesReturned

작업에서 생성된 데이터의 실제 크기(바이트)를 반환합니다. 이 정보가 필요하지 않은 경우 lpBytesReturned에 대해 NULL을 전달합니다.

반환 값

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

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

요구 사항

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