Função JetGetAttachInfo

Aplica-se a: Windows | Windows Server

Função JetGetAttachInfo

A função JetGetAttachInfo é usada durante um backup iniciado por JetBeginExternalBackup para consultar uma instância dos nomes dos arquivos de banco de dados que devem se tornar parte do conjunto de arquivos de backup. Somente os bancos de dados atualmente anexados à instância usando JetAttachDatabase serão considerados. Esses arquivos podem ser abertos posteriormente usando JetOpenFile e lidos usando JetReadFile.

    JET_ERR JET_API JetGetAttachInfo(
      __out_opt     tchar* szz,
      __in          unsigned long cbMax,
      __out_opt     unsigned long* pcbActual
    );

Parâmetros

Szz

O buffer de saída que recebe a lista de cadeias de caracteres terminadas em nulo que descrevem o conjunto de arquivos de banco de dados que deve fazer parte do conjunto de arquivos de backup. A lista de cadeias de caracteres retornadas nesse buffer está no mesmo formato de uma cadeia de caracteres múltipla usada pelo Registro. Cada cadeia de caracteres terminada em nulo é retornada em sequência seguida por um terminador nulo final.

cbMax

O tamanho máximo em bytes do buffer de saída.

pcbActual

Ponteiro para o buffer de saída que recebeu a quantidade real de dados de cadeia de caracteres.

Valor Retornado

Essa função retorna o tipo de dados JET_ERR com um dos seguintes códigos de retorno. Para obter mais informações sobre os possíveis erros de ESE, consulte Erros extensíveis do mecanismo de armazenamento e parâmetros de tratamento de erros.

Código de retorno	Descrição
JET_errSuccess	A operação foi concluída com sucesso.
JET_errBackupAbortByServer	A operação falhou porque o backup externo atual foi anulado por uma chamada para JetStopBackup. Esse erro só será retornado pelo Windows XP e versões posteriores.
JET_errClientRequestToStopJetService	Não é possível concluir a operação porque todas as atividades na instância associada à sessão cessaram como resultado de uma chamada para JetStopService.
JET_errInstanceUnavailable	Não é possível concluir a operação porque a instância associada à sessão encontrou um erro fatal que exige que o acesso a todos os dados seja revogado para proteger a integridade desses dados. Esse erro só será retornado pelo Windows XP e versões posteriores.
JET_errInvalidBackupSequence	A operação de backup falhou porque foi chamada fora de sequência. JetGetAttachInfo retornará esse erro se o backup atual não for um backup completo.
JET_errInvalidParameter	Um dos parâmetros fornecidos continha um valor inesperado ou continha um valor que não fazia sentido quando combinado com o valor de outro parâmetro. Isso pode acontecer para JetGetAttachInfo quando o identificador de instância especificado é inválido (Windows XP e versões posteriores).
JET_errNoBackup	A operação falhou porque nenhum backup externo está em andamento.
JET_errNotInitialized	Não é possível concluir a operação porque a instância associada à sessão ainda não foi inicializada.
JET_errRestoreInProgress	Não é possível concluir a operação porque uma operação de restauração está em andamento na instância associada à sessão.
JET_errRunningInMultiInstanceMode	A operação falhou porque foi feita uma tentativa de usar o mecanismo no modo herdado (modo de compatibilidade do Windows 2000) em que apenas uma instância tem suporte quando, na verdade, várias instâncias já existem.
JET_errTermInProgress	Não é possível concluir a operação porque a instância associada à sessão está sendo desligada.

Em caso de êxito, as informações solicitadas sobre o conjunto de arquivos de banco de dados que devem fazer parte do conjunto de arquivos de backup serão colocadas nos buffers de saída quando fornecidos.

Em caso de falha, o estado dos buffers de saída é indefinido. A falha resultará no cancelamento de todo o processo de backup para a instância.

Comentários

É importante observar que essa API não retornará um erro ou aviso se o buffer de saída for muito pequeno para aceitar a lista completa de arquivos que devem fazer parte do conjunto de arquivos de backup. O aplicativo sempre deve fornecer um buffer para receber o tamanho real dessa lista e usar essas informações para determinar se a lista foi truncada.

Requisitos

Requisito	Valor
Cliente	Requer Windows Vista, Windows XP ou Windows 2000 Professional.
Servidor	Requer o Windows Server 2008, o Windows Server 2003 ou o Windows 2000 Server.
Cabeçalho	Declarado em Esent.h.
Biblioteca	Use ESENT.lib.
DLL	Requer ESENT.dll.
Unicode	Implementado como JetGetAttachInfoW (Unicode) e JetGetAttachInfoA (ANSI).

Consulte Também

JET_ERR
JET_INSTANCE
JetAttachDatabase
JetBeginExternalBackup
JetOpenFile
JetReadFile
JetStopBackup
JetStopService