SisCSFilesToBackupForLink 함수
SisCSFilesToBackupForLink 함수는 지정된 SIS 링크가 가리키는 공통 저장소 파일을 설명하는 정보를 반환합니다.
구문
BOOL SisCSFilesToBackupForLink(
_In_ PVOID sisBackupStructure,
_In_ PVOID reparseData,
_In_ ULONG reparseDataSize,
_Out_ PVOID thisFileContext,
_Out_ PVOID *matchingFileContext,
_Out_ PULONG countOfCommonStoreFilesToBackUp,
_Out_ PWCHAR **commonStoreFilesToBackUp
);
매개 변수
-
sisBackupStructure [in]
-
SisCreateBackupStructure에서 반환된 SIS 백업 구조에 대한 포인터입니다.
-
reparseData [in]
-
SIS 재분석 지점의 내용에 대한 포인터입니다. 이 재분석 지점에는 SIS 링크를 설명하는 데이터가 포함되어 있습니다. 파일에 대한 재분석 지점 데이터를 검색하려면 FSCTL_GET_REPARSE_POINT 제어 코드를 사용합니다.
-
reparseDataSize [in]
-
reparseData가 가리키는 SIS 재분석 지점의 내용 크기(바이트)입니다.
-
thisFileContext [out]
-
이 함수를 호출하는 백업 애플리케이션에서 제공하는 컨텍스트 문자열에 대한 포인터입니다. 이 콘텐츠 문자열의 내용은 이 백업 애플리케이션에 의해 완전히 결정되며 SIS Backup API에서 해석되지 않습니다. 이 매개 변수는 선택 사항입니다. 사용하지 않으면 이 매개 변수의 값을 NULL로 설정합니다. 이 경우 이 매개 변수의 값이 처리되지 않습니다.
-
matchingFileContext [out]
-
이 함수의 처음 네 매개 변수에 전달된 정보로 식별되는 SIS 링크의 컨텍스트 문자열에 대한 이중 간접 포인터입니다. 이 매개 변수는 선택 사항입니다. 컨텍스트 문자열이 thisFileContext 매개 변수의 값으로 제공되지 않으면 이 매개 변수의 값을 NULL로 설정합니다. 이 경우 이 매개 변수의 값이 처리되지 않습니다.
-
countOfCommonStoreFilesToBackUp [out]
-
commonStoreFilesToBackUp 매개 변수에 나열된 파일 수입니다.
-
commonStoreFilesToBackUp [out]
-
파일 이름 배열에 대한 포인터입니다. 이러한 파일은 SisCreateBackupStructure에서 요청한 공통 저장소 파일과 동일한 방식으로 동시에 백업해야 합니다.
반환 값
이 함수는 성공적으로 완료되면 TRUE 를 반환하고 그렇지 않으면 FALSE 를 반환합니다. GetLastError를 호출하여 호출이 실패한 이유에 대한 자세한 정보를 가져옵니다.
설명
백업 애플리케이션은 백업 중인 각 SIS 링크 파일에 대해 이 함수를 한 번만 호출해야 합니다.
백업 애플리케이션은 태그로 SIS 재분석 지점을 식별할 수 IO_REPARSE_TAG_SIS. 이 태그는 Winnt.h에 정의되어 있습니다.
reparseData 매개 변수 값으로 식별된 이 재분석 지점이 백업할 파일의 첫 번째 instance 설명하는 경우 이 함수는 NULL을 matchingFileContext 매개 변수의 값으로 반환하고 백업할 공통 저장소 파일 또는 파일의 이름을 사용하여 문자열의 commonStoreFilesToBackUp 배열 값을 초기화합니다. 그렇지 않으면 이 함수는 matchingFileContext 매개 변수의 값을 지정된 파일의 첫 번째 instance 해당하는 컨텍스트 문자열로 설정하고 countOfCommonStoreFilesToBackUp 매개 변수의 값을 0으로 설정합니다. 지정된 링크에 해당하는 여러 공통 저장소 파일이 있는 경우 thisFileContext 매개 변수의 값은 commonStoreFilesToBackUp[0]인 배열에 반환된 첫 번째 common-store 파일에 해당하는 컨텍스트 문자열이 됩니다.
이 함수의 현재 버전은 최대 하나의 공통 저장소 파일을 반환하지만, 이후 버전에서는 백업 애플리케이션이 이 함수에 대한 각 호출에서 여러 파일을 지원하도록 파일의 각 스트림에 대해 하나씩과 같은 여러 공통 저장소 파일에서 단일 링크를 지원할 수 있습니다. 어쨌든 각 공통 저장소 파일은 각 백업 패스에 대해 최대 한 번 반환됩니다.
백업 애플리케이션은 commonStoreFilesToBackUp 매개 변수에 반환된 파일 이름 또는 파일 이름으로 식별된 공용 저장소 파일 또는 파일을 백업하거나 복원해야 합니다. 해당 공통 저장소 파일이 있는지 여부에 관계없이 백업 애플리케이션은 디스크에 있는 SIS 링크 파일을 다시 분석 지점 및 스파스 파일과 같이 백업해야 하며 범위가 채워지지 않을 가능성이 큽니다. 백업 애플리케이션은 공용 저장소 파일 또는 파일을 즉시 백업하거나 복원하거나, 백업을 연기하거나, 필요에 따라 함께 혼합할 수 있습니다.
백업 작업이 완료되면 SisFreeAllocatedMemory를 호출하여 문자열의 commonStoreFilesToBackUp 배열에서 사용하는 메모리의 할당을 취소합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| 헤더 |
|
| 라이브러리 |
|
| DLL |
|