리소스에 영향을 주는 작업을 시작합니다.
수행되는 작업은 dwControlCode 매개 변수에 전달된 제어 코드에 따라 달라집니다.
구문
DWORD ClusterResourceControlAsUser(
[in] HRESOURCE hResource,
[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] hResource
영향을 받을 리소스에 대한 핸들입니다.
[in, optional] hHostNode
작업을 수행할 노드에 대한 선택적 핸들입니다. NULL이면 hResource로 식별된 리소스를 소유하는 노드가 작업을 수행합니다.
[in] dwControlCode
수행할 작업을 지정하는 CLUSCTL_RESOURCE_CODES 열거형으로 열거된 리소스 제어 코드입니다. 컨트롤 코드와 연결된 구문은 을 참조하세요.
CLUSCTL_RESOURCE_CODES 항목의 링크입니다.
[in, optional] lpInBuffer
작업에 필요한 정보를 포함하는 입력 버퍼에 대한 포인터이거나 정보가 필요하지 않은 경우 NULL 입니다.
[in] cbInBufferSize
입력 버퍼의 할당된 크기(바이트)입니다.
[out, optional] lpOutBuffer
작업에서 생성된 데이터를 수신할 출력 버퍼에 대한 포인터이거나, 반환되는 데이터가 없는 경우 NULL 입니다.
[in] cbOutBufferSize
출력 버퍼의 할당된 크기(바이트)입니다.
[out, optional] lpBytesReturned
작업으로 인한 데이터의 실제 크기(바이트)를 반환합니다. 이 정보가 필요하지 않은 경우 lpBytesReturned에 대해 NULL을 전달합니다.
반환 값
함수는 다음 값 중 하나를 반환합니다.
| 반환 코드/값 | 설명 |
|---|---|
|
작업이 완료되었습니다. 작업에 출력 버퍼가 필요한 경우 lpBytesReturned (입력 시 NULL 이 아닌 경우)은 버퍼에 반환된 데이터의 실제 크기를 가리킵니다. |
|
lpOutBuffer가 가리키는 출력 버퍼가 작업으로 인한 데이터를 저장할 만큼 크지 않았습니다. lpBytesReturned 매개 변수(입력 시 NULL이 아닌 경우)는 출력 버퍼에 필요한 크기를 가리킵니다. 출력 버퍼가 필요한 작업만 ERROR_MORE_DATA. lpOutBuffer 매개 변수가 NULL이고 cbOutBufferSize 매개 변수가 0이면 ERROR_MORE_DATA 아니라 ERROR_SUCCESS 반환될 수 있습니다. |
|
CLUSCTL_RESOURCE_SET_COMMON_PROPERTIES 및 CLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIES만 적용됩니다. 속성이 성공적으로 저장되었지만 아직 리소스에 적용되지 않음을 나타냅니다. 리소스가 오프라인으로 전환되고 다시 온라인 상태가 되면 새 속성이 적용됩니다. |
|
hNode 매개 변수로 지정된 노드는 hResource에서 지정한 리소스를 소유하는 노드가 아닙니다. |
| 작업이 성공하지 못했습니다. 작업에 출력 버퍼가 필요한 경우 lpBytesRe가 지정한 값(입력 시 NULL 이 아닌 경우)은 신뢰할 수 없습니다. |
설명
ClusterResourceControl이ERROR_MORE_DATA 반환하는 경우 cbOutBufferSize를 lpBytesReturned이 가리키는 바이트 수로 설정하고 함수를 다시 호출합니다.
LPC 및 RPC 핸들을 동일한 함수 호출에 전달하지 마세요. 그렇지 않으면 호출이 RPC 예외를 발생시키고 추가적인 파괴적인 영향을 미칠 수 있습니다. LPC 및 RPC 핸들을 만드는 방법에 대한 자세한 내용은 LPC 및 RPC 핸들 및 OpenCluster를 참조하세요.
ClusterResourceControl 함수는 제어 코드 함수 중 하나입니다. 제어 코드 및 제어 코드 함수에 대한 자세한 내용은 제어 코드 사용을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2016 |
| 대상 플랫폼 | Windows |
| 헤더 | clusapi.h |
| 라이브러리 | ClusAPI.lib |
| DLL | ClusAPI.dll |