Função SisCreateRestoreStructure
A função SisCreateRestoreStructure cria uma estrutura de restauração do SIS com base nas informações fornecidas.
Sintaxe
BOOL SisCreateRestoreStructure(
_In_ PWCHAR volumeRoot,
_Out_ PVOID *sisRestoreStructure,
_Out_ PWCHAR *commonStoreRootPathname,
_Out_ PULONG countOfCommonStoreFilesToRestore,
_Out_ PWCHAR **commonStoreFilesToRestore
);
Parâmetros
-
volumeRoot [in]
-
Nome do arquivo da raiz do volume, sem a barra invertida à direita, do volume a ser copiado em backup. Por exemplo, especifique "C:" e não "C:\". O volume não pode ser o sistema ou o volume de inicialização.
-
sisRestoreStructure [out]
-
Estrutura de restauração do SIS retornada. Essa estrutura deve ser tratada como opaca pelo chamador.
-
commonStoreRootPathname [out]
-
Nome do caminho totalmente qualificado do repositório comum do volume especificado. Por exemplo, "c:\SIS Common Store".
-
countOfCommonStoreFilesToRestore [out]
-
Número de arquivos listados no parâmetro commonStoreFilesToRestore .
-
commonStoreFilesToRestore [out]
-
Ponteiro para uma matriz de nomes de arquivo que especifica a lista de arquivos internos usados pelo SIS para gerenciar o volume especificado. Esses arquivos devem ser restaurados ao mesmo tempo e da mesma maneira que os arquivos de armazenamento comum 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 pelo qual a chamada falhou.
Comentários
Essa função estabelece o ambiente de restauração no volume especificado da maneira como SisCreateBackupStructure estabelece o ambiente de backup no volume especificado.
Observe que essa função não identificará necessariamente o arquivo de armazenamento comum ou os arquivos correspondentes a um conjunto de links do SIS na mídia de backup se esses arquivos comuns do repositório ainda existirem no disco. O conteúdo do fluxo de dados de um arquivo de armazenamento comum nunca é alterado depois de criado, portanto, se o arquivo já existir no disco, não será necessário restaurá-lo.
Os nomes de arquivo de repositório comum são globalmente exclusivos para garantir a integridade da operação de restauração, mesmo que ela não ocorra no mesmo volume habilitado para SIS que a operação de backup acessou.
Após a conclusão da operação de restauração, desaloque a memória usada pela matriz commonStoreFilesToRestore 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 |
|