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 連結，都不會傳回該通用存放區檔案名。
此函式不會在備份作業期間傳回未在呼叫 SisCSFilesToBackupForLink 時傳回的一般存放區檔案，假設 SIS 重新分析媒體上儲存的資料尚未損毀。
還原 SIS 連結時，還原作業應該只建立適當的疏鬆檔案、初始化任何配置的範圍，然後寫入 SIS 重新分析資料，就像備份作業期間讀取一樣。 還原作業必須建立未配置範圍的疏鬆檔案，而不是疏鬆檔案 (或非剖析檔案，) 以零初始化。
請注意，如果這些通用存放區檔案或檔案仍然存在於磁片上，則此函式不一定會識別對應至備份媒體上一組 SIS 連結的通用存放區檔案或檔案。 一旦建立通用存放區檔案的資料流程內容永遠不會變更，因此，如果檔案已存在於磁片上，就不需要還原它。
一般存放區檔案名是全域唯一的，可確保還原作業的完整性，即使它未發生在備份作業存取的相同啟用 SIS 的磁片區上也一樣。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2003 [僅限傳統型應用程式] |
| 標頭 |
|
| 程式庫 |
|
| DLL |
|