Função SisCreateBackupStructure
A função SisCreateBackupStructure cria uma estrutura de backup do SIS com base nas informações fornecidas.
Sintaxe
BOOL SisCreateBackupStructure(
_In_ PWCHAR volumeRoot,
_Out_ PVOID *sisBackupStructure,
_Out_ PWCHAR *commonStoreRootPathname,
_Out_ PULONG countOfCommonStoreFilesToBackUp,
_Out_ PWCHAR **commonStoreFilesToBackUp
);
Parâmetros
-
volumeRoot [in]
-
Nome do arquivo da raiz do volume, sem a barra invertida à direita, do volume a ser feito o backup. Por exemplo, especifique "C:" e não "C:\".
-
sisBackupStructure [out]
-
Estrutura de backup do SIS retornada.
-
commonStoreRootPathname [out]
-
Nome de caminho totalmente qualificado do repositório comum do volume especificado. Por exemplo, "c:\SIS Common Store".
-
countOfCommonStoreFilesToBackUp [out]
-
Número de arquivos listados no parâmetro commonStoreFilesToBackUp .
-
commonStoreFilesToBackUp [out]
-
Ponteiro para uma matriz de nomes de arquivo que especifica uma lista de arquivos internos usados pelo SIS para gerenciar o volume especificado. Esses arquivos devem ser copiados em backup ao mesmo tempo e da mesma maneira que os arquivos de repositório comuns solicitados por SisCSFilesToBackupForLink
Valor retornado
Essa função retornará TRUE se for concluída com êxito e FALSE caso contrário. Chame GetLastError para obter mais informações sobre o motivo da falha na chamada.
Comentários
Essa função cria uma estrutura de backup do SIS, que é usada pela API de backup do SIS para criar e manter uma lista dos links de arquivo no volume e os arquivos originais aos quais os links apontam. Essa função deve ser chamada apenas uma vez para cada volume habilitado para SIS que está sendo feito backup. Todos os arquivos dentro do volume especificado devem ser tratados como arquivos de repositório comum e feito backup somente se o SIS indicar que eles devem.
Os parâmetros countOfCommonStoreFilesToBackUp e commonStoreFilesToBackUp retornam juntos uma lista de arquivos que devem ser copiados em backup, independentemente de quais links são backup.
Se countOfCommonStoreFilesToBackUp for 0, commonStoreFilesToBackUp poderá ser um ponteiro NULL . O valor do parâmetro commonStoreFilesToBackUp deve ser ignorado.
Depois que a operação de backup for concluída, desaloque a memória usada pela matriz commonStoreFilesToBackUp de cadeias de caracteres chamando SisFreeAllocatedMemory.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|