Função SisCSFilesToBackupForLink
A função SisCSFilesToBackupForLink retorna informações que descrevem os arquivos de armazenamento comum para os quais o link do SIS especificado aponta.
Sintaxe
BOOL SisCSFilesToBackupForLink(
_In_ PVOID sisBackupStructure,
_In_ PVOID reparseData,
_In_ ULONG reparseDataSize,
_Out_ PVOID thisFileContext,
_Out_ PVOID *matchingFileContext,
_Out_ PULONG countOfCommonStoreFilesToBackUp,
_Out_ PWCHAR **commonStoreFilesToBackUp
);
Parâmetros
-
sisBackupStructure [in]
-
Ponteiro para a estrutura de backup do SIS retornada de SisCreateBackupStructure.
-
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 um link do SIS. 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.
-
thisFileContext [out]
-
Ponteiro para uma cadeia de caracteres de contexto fornecida pelo aplicativo de backup que chama essa função. O conteúdo dessa cadeia de caracteres de conteúdo é totalmente determinado por esse aplicativo de backup e não é interpretado pela API de Backup do SIS. Esse parâmetro é opcional; se não for usado, defina o valor desse parâmetro como NULL. O valor desse parâmetro não será processado nesse caso.
-
matchingFileContext [out]
-
Ponteiro duplamente indireto para a cadeia de caracteres de contexto do link do SIS identificado pelas informações passadas nos quatro primeiros parâmetros dessa função. Esse parâmetro é opcional; se uma cadeia de caracteres de contexto não for fornecida como o valor do parâmetro thisFileContext , defina o valor desse parâmetro como NULL. O valor desse parâmetro não será processado nesse caso.
-
countOfCommonStoreFilesToBackUp [out]
-
Número de arquivos listados no parâmetro commonStoreFilesToBackUp .
-
commonStoreFilesToBackUp [out]
-
Ponteiro para uma matriz de nomes de arquivo. Esses arquivos devem ser copiados em backup ao mesmo tempo e da mesma maneira que os arquivos de armazenamento comum solicitados por SisCreateBackupStructure.
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
O aplicativo de backup deve chamar essa função apenas uma vez para cada arquivo de link do SIS que está sendo copiado em backup.
O aplicativo de backup pode identificar um ponto de nova análise do SIS por sua marca, IO_REPARSE_TAG_SIS. Essa marca é definida em Winnt.h.
Se esse ponto de nova análise identificado pelo valor do parâmetro reparseData descrever a primeira instância de um arquivo a ser copiado em backup, essa função retornará NULL como o valor do parâmetro matchingFileContext e inicializará o valor da matriz commonStoreFilesToBackUp de cadeias de caracteres com os nomes do arquivo ou arquivos do repositório comum a serem copiados em backup. Caso contrário, essa função definirá o valor do parâmetro matchingFileContext para a cadeia de caracteres de contexto correspondente à primeira instância do arquivo especificado e definirá o valor do parâmetro countOfCommonStoreFilesToBackUp como 0. Se houver vários arquivos de repositório comuns correspondentes ao link especificado, o valor do parâmetro thisFileContext será a cadeia de caracteres de contexto correspondente ao primeiro arquivo de repositório comum retornado na matriz, ou seja, commonStoreFilesToBackUp[0].
A versão atual dessa função retornará no máximo um arquivo de repositório comum, mas é possível que, em versões futuras, um único link possa ser apoiado por vários arquivos de armazenamento comum, por exemplo, um para cada fluxo no arquivo, de modo que seu aplicativo de backup deve dar suporte a vários arquivos em cada chamada para essa função. De qualquer forma, cada arquivo de repositório comum será retornado no máximo uma vez para cada passagem de backup.
Seu aplicativo de backup deve fazer backup ou restaurar o arquivo de repositório comum ou arquivos identificados pelo nome do arquivo ou nomes de arquivo retornados no parâmetro commonStoreFilesToBackUp . Independentemente de haver um arquivo de repositório comum correspondente, seu aplicativo de backup deve fazer backup do arquivo de link do SIS como ele existe no disco, por exemplo, como um ponto de nova análise e um arquivo esparso e, provavelmente, sem intervalos preenchidos. Seu aplicativo de backup pode fazer backup ou restaurar imediatamente o arquivo ou os arquivos do repositório comum, adiar o backup deles ou misturá-los conforme necessário.
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 |
|