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 備份 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 參數的值所識別的這個重新剖析點描述要備份之檔案的第一個實例，此函式會傳回 Null 做為 matchingFileCoNtext 參數的值，並使用要備份的通用存放區檔案或檔案名，初始化 字串的 commonStoreFilesToBackUp 陣列值。 否則，此函式會將 matchingFileCoNtext 參數的值設定為對應至指定檔案第一個實例的內容字串，並將 countOfCommonStoreFilesToBackUp 參數的值設定為 0。 如果有多個通用存放區檔案對應至指定的連結， thisFileCoNtext 參數的值將會是對應至陣列中傳回的第一個通用存放區檔案的內容字串，也就是 commonStoreFilesToBackUp[0]。
此函式的目前版本最多會傳回一個通用存放區檔案，但在未來的版本中，單一連結可能會受到數個通用存放區檔案的支援，例如，檔案中的每個資料流程各有一個，因此您的備份應用程式應該在每次呼叫此函式時支援多個檔案。 在任何情況下，每個一般存放區檔案最多都會針對每個備份階段傳回一次。
您的備份應用程式應該備份或還原 commonStoreFilesToBackUp 參數中傳回之檔案名所識別的一般存放區檔案或檔案。 不論是否有對應的通用存放區檔案，您的備份應用程式都應該備份磁片上存在的 SIS 連結檔案，例如重新分析點和疏鬆檔案，而且最有可能未填入範圍。 您的備份應用程式可以立即備份或還原通用存放區檔案或檔案、延後備份，或視需要將它們混合在一起。
備份作業完成之後，呼叫SisFreeAllocatedMemory來解除配置commonStoreFilesToBackUp字串陣列所使用的記憶體。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2003 [僅限桌面應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|