POFFLINE_V2_ROUTINE 콜백 함수(resapi.h)

아티클
03/05/2024

정리 처리가 완료된 후 리소스 를 사용할 수 없음으로 표시합니다. POFFLINE_V2_ROUTINE 형식은 이 함수에 대한 포인터를 정의합니다.

구문

POFFLINE_V2_ROUTINE PofflineV2Routine;

DWORD PofflineV2Routine(
  [in]           RESID Resource,
  [in, optional] LPCWSTR DestinationNodeName,
  [in]           DWORD OfflineFlags,
  [in, optional] PBYTE InBuffer,
  [in]           DWORD InBufferSize,
  [in]           DWORD Reserved
)
{...}

매개 변수

[in] Resource

오프라인으로 전환할 리소스의 리소스 식별자입니다.

[in, optional] DestinationNodeName

작업이 완료된 경우 리소스를 포함할 노드의 이름입니다.

[in] OfflineFlags

이 작업에 대한 설정을 지정하는 플래그의 비트 마스크입니다. 이 매개 변수는 다음 값 중 하나 이상으로 설정할 수 있습니다.

CLUS_RESDLL_OFFLINE_IGNORE_RESOURCE_STATUS(0x00000001)

리소스가 잠겨 있어야 한다고 나타내는 경우에도 작업을 수행합니다.

CLUS_RESDLL_OFFLINE_RETURN_TO_SOURCE_NODE_ON_ERROR(0x00000002)

리소스에 오류가 발생하면 원본 노드로 반환합니다.

CLUS_RESDLL_OFFLINE_QUEUE_ENABLED(0x00000004)

리소스 DLL에 의해 지연된 경우 작업을 큐에 넣은 다음 클라이언트가 작업을 완료하거나 취소할 때까지 작업을 다시 시도합니다.

CLUS_RESDLL_OFFLINE_RETURNING_TO_SOURCE_NODE_BECAUSE_OF_ERROR(0x00000008)

리소스에 오류가 발생했으며 원본 노드로 돌아가고 있음을 나타냅니다.

CLUS_RESDLL_OFFLINE_DUE_TO_EMBEDDED_FAILURE(0x00000010)

포함된 오류가 있음을 나타냅니다.

CLUS_RESDLL_OFFLINE_IGNORE_NETWORK_CONNECTIVITY(0x00000020)

네트워크 오류가 있더라도 작업을 수행합니다.

Windows Server 2012: 이 값은 R2를 Windows Server 2012 전에 지원되지 않습니다.

CLUS_RESDLL_OFFLINE_DO_NOT_UPDATE_PERSISTENT_STATE(0x00000040)

리소스의 영구 상태를 업데이트하지 마세요.

Windows Server 2012 R2 및 Windows Server 2012: 이 값은 Windows Server 2016 전에 지원되지 않습니다.

[in, optional] InBuffer

작업에 대한 데이터를 포함하는 버퍼에 대한 포인터입니다. 그렇지 않으면 작업에 데이터가 필요하지 않은 경우 NULL 입니다.

[in] InBufferSize

InBuffer 매개 변수의 크기(바이트)입니다.

[in] Reserved

예약되어 있습니다.

반환 값

반환 코드/값	설명
ERROR_SUCCESS 0	요청이 성공적으로 완료되고 리소스가 오프라인 상태입니다.
ERROR_IO_PENDING 997(0x3E5)	요청이 아직 보류 중이며 오프라인 요청을 처리하기 위해 스레드가 활성화되었습니다.

다른 이유로 작업이 성공하지 못한 경우 이 함수는 시스템 오류 코드 중 하나를 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2012
대상 플랫폼	Windows
헤더	resapi.h

추가 정보

리소스 DLL 진입점 함수

다음을 통해 공유