다음을 통해 공유

ClusterResourceTypeControl 함수(clusapi.h)

  • 아티클

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

구문

DWORD ClusterResourceTypeControl(
  [in]            HCLUSTER hCluster,
  [in]            LPCWSTR  lpszResourceTypeName,
  [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

lpszResourceTypeName에서 식별된 리소스 유형을 포함하는 클러스터에 대한 핸들입니다.

[in] lpszResourceTypeName

영향을 받을 리소스 유형의 이름을 포함하는 NULL로 종료된 유니코드 문자열에 대한 포인터입니다.

[in, optional] hHostNode

영향을 받는 리소스 종류를 호스트하는 노드에 대한 핸들입니다.

[in] dwControlCode

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

[in, optional] lpInBuffer

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

[in] nInBufferSize

lpInBuffer가 가리키는 버퍼의 바이트 수입니다.

[out, optional] lpOutBuffer

작업으로 인한 정보가 포함된 출력 버퍼에 대한 포인터이거나, 반환되지 않을 경우 NULL 입니다.

[in] nOutBufferSize

lpOutBuffer가 가리키는 출력 버퍼의 바이트 수 또는 호출자가 반환되는 데이터의 양을 모르는 경우 0입니다.

[out, optional] lpBytesReturned

작업의 결과로 실제로 채워진 lpOutBuffer 가 가리키는 버퍼의 바이트 수에 대한 포인터입니다. ClusterResourceTypeControl이 출력 버퍼의 바이트 수를 다시 전달할 필요가 없는 경우 호출자는 lpBytesReturned에 대해 NULL을 전달할 수 있습니다.

반환 값

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

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

설명

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

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

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

요구 사항

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

추가 정보

OpenCluster

리소스 종류 제어 코드