PFE_EXPORT_FUNC 콜백 함수(winbase.h)

아티클
03/08/2023

ReadEncryptedFileRaw와 함께 사용되는 애플리케이션 정의 콜백 함수입니다. 시스템은 모든 파일 데이터를 받을 때까지 암호화된 파일 데이터의 블록과 함께 매번 ExportCallback 을 하나 이상 호출합니다. ExportCallback 은 일반적으로 파일을 백업하기 위해 암호화된 파일의 데이터를 다른 스토리지 미디어에 씁니다.

PFE_EXPORT_FUNC 형식은 콜백 함수에 대한 포인터를 정의합니다. ExportCallback 은 애플리케이션 정의 함수 이름의 자리 표시자입니다.

구문

PFE_EXPORT_FUNC PfeExportFunc;

DWORD PfeExportFunc(
  [in]           PBYTE pbData,
  [in, optional] PVOID pvCallbackContext,
  [in]           ULONG ulLength
)
{...}

매개 변수

[in] pbData

백업할 암호화된 파일 데이터 블록에 대한 포인터입니다. 이 데이터 블록은 시스템에 의해 할당됩니다.

[in, optional] pvCallbackContext

애플리케이션 정의 및 할당된 컨텍스트 블록에 대한 포인터입니다. 애플리케이션은 이 포인터를 ReadEncryptedFileRaw에 전달하고 ReadEncryptedFileRaw 는 애플리케이션별 데이터에 액세스할 수 있도록 이 포인터를 콜백 함수에 전달합니다. 이 데이터는 구조일 수 있으며 암호화된 파일의 백업 복사본을 포함하는 파일에 대한 핸들과 같이 애플리케이션에 필요한 모든 데이터를 포함할 수 있습니다.

[in] ulLength

pbData 매개 변수가 가리키는 데이터의 크기(바이트)입니다.

반환 값

함수가 성공하면 반환 값을 ERROR_SUCCESS 설정해야 합니다.

함수가 실패하면 반환 값을 WinError.h에 정의된 0이 아닌 오류 코드로 설정합니다. 예를 들어 호출하는 API가 실패하여 이 함수가 실패하는 경우 반환 값을 실패한 API에 대해 GetLastError 에서 반환된 값으로 설정할 수 있습니다.

설명

파일 핸들 및 파일의 현재 오프셋과 같은 정보의 내부 추적에 애플리케이션 정의 컨텍스트 블록을 사용할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winbase.h(Windows.h 포함)