Função SisRestoredLink

A função SisRestoredLink retorna os nomes do arquivo de armazenamento comum ou arquivos apontados pelo link do SIS restaurado especificado.

Sintaxe

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

Parâmetros

sisRestoreStructure [in]

Ponteiro para uma estrutura de restauração do SIS retornada de SisCreateRestoreStructure.

restoredFileName [in]

Nome de arquivo totalmente qualificado do arquivo de link do SIS restaurado.

reparseData [in]

Ponteiro para o conteúdo do ponto de nova análise do SIS. Esse ponto de nova análise contém dados que descrevem o link do SIS restaurado. Para recuperar os dados de ponto de nova análise de um arquivo, use o código de controle FSCTL_GET_REPARSE_POINT .

reparseDataSize [in]

Tamanho do conteúdo do ponto de nova análise do SIS apontado por reparseData, em bytes.

countOfCommonStoreFilesToRestore [out]

Número de arquivos listados no parâmetro commonStoreFilesToRestore .

commonStoreFilesToRestore [out]

Ponteiro para uma matriz de nomes de arquivo de repositório comum. Esses arquivos devem ser restaurados ao mesmo tempo e da mesma maneira que os arquivos de armazenamento comum solicitados por SisCSFilesToBackupForLink.

Se o valor do parâmetro countOfCommonStoreFilesToRestore não for 0, o valor do parâmetro commonStoreFilesToRestore conterá os nomes dos arquivos de repositório comuns a serem restaurados como resultado da restauração do link do SIS. Se o valor for 0, os arquivos de armazenamento comum serão retornados uma vez ou já estiverem presentes no volume.

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

Você deve chamar essa função para cada link do SIS que foi restaurado.

Essa função retornará cada arquivo de repositório comum no máximo uma vez para cada operação de restauração; qualquer tentativa de restaurar links adicionais do SIS que veem o mesmo arquivo de repositório comum não resultará no retorno desse nome de arquivo de repositório comum.

Essa função não retornará um arquivo de repositório comum que também não foi retornado em uma chamada para SisCSFilesToBackupForLink durante a operação de backup, supondo que os dados de nova análise do SIS armazenados na mídia não foram corrompidos.

Ao restaurar um link do SIS, sua operação de restauração deve criar apenas o arquivo esparso apropriado, inicializar os intervalos alocados e gravar os dados de nova análise do SIS exatamente como foram lidos durante a operação de backup. É crucial que sua operação de restauração crie arquivos esparsos com intervalos não alocados em vez de arquivos esparsos (ou arquivos sem análise) inicializados com zeros.

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 ou arquivos de armazenamento comum ainda existirem no disco. O conteúdo do fluxo de dados de um arquivo de repositório comum nunca é alterado depois que ele é criado, portanto, se o arquivo já existe no disco, não há necessidade de 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 acessado pela operação de backup.

Requisitos

Confira também

SisCreateRestoreStructure

SisCSFilesToBackupForLink