SisRestoredLink 함수

SisRestoredLink 함수는 지정된 복원된 SIS 링크가 가리키는 공용 저장소 파일 또는 파일의 이름을 반환합니다.

구문

BOOL SisRestoredLink(
  _In_  PVOID  sisRestoreStructure,
  _In_  PWCHAR restoredFileName,
  _In_  PVOID  reparseData,
  _In_  ULONG  reparseDataSize,
  _Out_ PULONG countOfCommonStoreFilesToRestore,
  _Out_ PWCHAR **commonStoreFilesToRestore
);

매개 변수

sisRestoreStructure [in]

SisCreateRestoreStructure에서 반환된 SIS 복원 구조체에 대한 포인터입니다.

restoredFileName [in]

복원된 SIS 링크 파일의 정규화된 파일 이름입니다.

reparseData [in]

SIS 재분석 지점의 내용에 대한 포인터입니다. 이 재분석 지점에는 복원된 SIS 링크를 설명하는 데이터가 포함되어 있습니다. 파일에 대한 재분석 지점 데이터를 검색하려면 FSCTL_GET_REPARSE_POINT 제어 코드를 사용합니다.

reparseDataSize [in]

reparseData가 가리키는 SIS 재분석 지점의 내용 크기(바이트)입니다.

countOfCommonStoreFilesToRestore [out]

commonStoreFilesToRestore 매개 변수에 나열된 파일 수입니다.

commonStoreFilesToRestore [out]

공통 저장소 파일 이름의 배열에 대한 포인터입니다. 이러한 파일은 SisCSFilesToBackupForLink에서 요청한 공통 저장소 파일과 동일한 방식으로 동시에 복원해야 합니다.

countOfCommonStoreFilesToRestore 매개 변수 값이 0이 아닌 경우 commonStoreFilesToRestore 매개 변수의 값에는 SIS 링크를 복원한 결과로 복원할 공용 저장소 파일의 이름이 포함됩니다. 값이 0이면 공통 저장소 파일이 한 번 반환되었거나 이미 볼륨에 있습니다.

반환 값

이 함수는 성공적으로 완료되면 TRUE 를 반환하고 그렇지 않으면 FALSE 를 반환합니다. GetLastError를 호출하여 호출이 실패한 이유에 대한 자세한 정보를 가져옵니다.

설명

복원된 각 SIS 링크에 대해 이 함수를 호출해야 합니다.

이 함수는 각 복원 작업에 대해 각 공통 저장소 파일을 최대 한 번 반환합니다. 동일한 공통 저장소 파일이 표시되는 추가 SIS 링크를 복원하려고 하면 해당 공통 저장소 파일 이름이 반환되지 않습니다.

이 함수는 미디어에 저장된 SIS 재분석 데이터가 손상되지 않았다고 가정하여 백업 작업 중에 SisCSFilesToBackupForLink 호출에서도 반환되지 않은 공통 저장소 파일을 반환하지 않습니다.

SIS 링크를 복원할 때 복원 작업은 적절한 스파스 파일만 만들고, 할당된 범위를 초기화한 다음, 백업 작업 중에 읽은 그대로 SIS 재분석 데이터를 작성해야 합니다. 복원 작업은 0으로 초기화된 스파스 파일(또는 비분석 파일)이 아닌 할당되지 않은 범위로 스파스 파일을 만드는 것이 중요합니다.

이 함수는 공통 저장소 파일 또는 파일이 여전히 디스크에 있는 경우 백업 미디어의 SIS 링크 집합에 해당하는 공용 저장소 파일 또는 파일을 반드시 식별하지는 않습니다. 공용 저장소 파일의 데이터 스트림의 내용은 생성된 후에는 변경되지 않으므로 디스크에 파일이 이미 있는 경우 복원할 필요가 없습니다.

일반 저장소 파일 이름은 백업 작업에서 액세스한 것과 동일한 SIS 사용 볼륨에서 발생하지 않더라도 복원 작업의 무결성을 보장하기 위해 전역적으로 고유합니다.

요구 사항

추가 정보

SisCreateRestoreStructure

SisCSFilesToBackupForLink