PFE_IMPORT_FUNC 콜백 함수(winbase.h)

아티클
08/27/2023

WriteEncryptedFileRaw와 함께 사용되는 애플리케이션 정의 콜백 함수입니다. 시스템은 백업 파일의 일부 데이터를 검색할 때마다 ImportCallback을 한 번 이상 호출합니다. ImportCallback 은 백업 파일에서 데이터를 순차적으로 읽고 데이터를 복원하며, 시스템은 모든 백업 파일 데이터를 읽을 때까지 계속 호출합니다.

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

구문

PFE_IMPORT_FUNC PfeImportFunc;

DWORD PfeImportFunc(
  [in]           PBYTE pbData,
  [in, optional] PVOID pvCallbackContext,
  [in, out]      PULONG ulLength
)
{...}

매개 변수

[in] pbData

복원할 데이터 블록을 수신하는 시스템 제공 버퍼에 대한 포인터입니다.

[in, optional] pvCallbackContext

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

[in, out] ulLength

함수 항목에서 이 매개 변수는 시스템에서 제공한 버퍼의 길이를 지정합니다. 콜백 함수는 pbData 매개 변수가 가리키는 버퍼에 이 바이트 수를 초과하지 않아야 합니다.

종료 시 함수는 이를 pbData에 기록된 데이터 바이트 수로 설정해야 합니다.

반환 값

함수가 성공하면 반환 값을 ERROR_SUCCESS 설정하고 ulLength 매개 변수가 가리키는 값을 pbData에 복사된 바이트 수로 설정해야 합니다.

백업 파일의 끝에 도달하면 ulLength 를 0으로 설정하여 전체 파일이 처리되었음을 시스템에 알릴 수 있습니다.

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

설명

콜백 함수가 복원할 데이터가 더 이상 없음을 나타내기 전까지 시스템은 ImportCallback 함수를 호출합니다. 복원할 데이터가 더 이상 없음을 나타내려면 *ulLength 를 0으로 설정하고 ERROR_SUCCESS 반환 코드를 사용합니다. 파일 핸들 및 파일의 현재 오프셋과 같은 정보를 내부적으로 추적하는 데 애플리케이션 정의 컨텍스트 블록을 사용할 수 있습니다.

요구 사항


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