Função de retorno de chamada JET_PFNSTATUS

Aplica-se a: Windows | Windows Server

Função de retorno de chamada JET_PFNSTATUS

A função de retorno de chamada JET_PFNSTATUS recebe informações sobre o progresso de operações de execução prolongada, como operações de desfragmentação, backup ou restauração. Durante essas operações, o mecanismo de banco de dados chama essa função de retorno de chamada para fornecer uma atualização sobre o andamento da operação.

    JET_ERR JET_API JET_PFNSTATUS(
                           JET_SESID  sesid,
                           JET_SNP snp,
                           JET_SNT snt,
                           void* pv
    );

Parâmetros

sesid

A sessão do tipo JET_SESID com a qual a função de execução longa foi chamada.

Snp

O tipo de operação conforme especificado em JET_SNP. Os tipos de operações incluem reparo, compactação, restauração, backup, atualização, depuração e atualização do formato de registro.

Snt

O status de uma operação. Os tipos de status incluem início, em andamento, conclusão ou falha. O status será especificado com o terceiro parâmetro do tipo JET_SNT.

pv

Um ponteiro opcional para uma estrutura do tipo JET_SNPROG.

Valor Retornado

Essa função retorna o tipo de dados JET_ERR com um dos códigos de erro do Mecanismo de Armazenamento Extensível. 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.

Em caso de êxito, a operação que emitiu o retorno de chamada pode continuar normalmente. Em alguns casos, o retorno de chamada pode retornar um aviso que influencia essa operação.

Em caso de falha, a operação que emitiu o retorno de chamada pode continuar normalmente ou pode falhar.

Comentários

Essa função de retorno de chamada será usada em uma notificação de progresso na qual a estrutura indicará o estado atual do progresso. Observe que a função de retorno de chamada pode ser chamada várias vezes para o progresso da operação.

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.

Consulte Também

Códigos de erro extensíveis do Mecanismo de Armazenamento
Erros extensíveis do mecanismo de armazenamento
JET_SESID
JET_SNP
JET_SNPROG
JET_SNT