Função JetUnregisterCallback
Aplica-se a: Windows | Windows Server
Função JetUnregisterCallback
A função JetUnregisterCallback permite que o aplicativo configure o mecanismo de banco de dados para interromper a emissão de notificações para o aplicativo, conforme solicitado anteriormente por meio de JetRegisterCallback.
Windows XP:JetUnregisterCallback é introduzido no Windows XP.
JET_ERR JET_API JetUnregisterCallback(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__in JET_CBTYP cbtyp,
__in JET_HANDLE hCallbackId
);
Parâmetros
sesid
A sessão a ser usada para essa chamada.
Tableid
O cursor a ser usado para essa chamada.
cbtyp
Uma máscara de bits composta pelos motivos de retorno de chamada que o aplicativo não deseja mais receber notificações.
Para criar essa máscara de bits, basta ou reúna motivos de retorno de chamada válidos da enumeração JET_CBTYP .
hCallbackId
O identificador do retorno de chamada registrado que foi retornado por JetRegisterCallback.
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_errClientRequestToStopJetService |
A operação não pode ser concluída porque todas as atividades na instância associada à sessão cessaram como resultado de uma chamada para JetStopService. |
JET_errInstanceUnavailable |
A operação não pode ser concluída 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. Windows XP: Esse valor retornado é introduzido no Windows XP. |
JET_errNotInitialized |
A operação não pode ser concluída porque a instância associada à sessão ainda não foi inicializada. |
JET_errRestoreInProgress |
A operação não pode ser concluída porque uma operação de restauração está em andamento na instância associada à sessão. |
JET_errSessionSharingViolation |
A mesma sessão não pode ser usada para mais de um thread ao mesmo tempo. Windows XP: Esse valor retornado é introduzido no Windows XP. |
JET_errTermInProgress |
A operação não pode ser concluída porque a instância associada à sessão está sendo desligada. |
Se essa função for bem-sucedida, o retorno de chamada especificado não será registrado pelos motivos de retorno de chamada fornecidos com a tabela associada ao cursor fornecido. Nenhuma alteração no estado do banco de dados ocorrerá.
Se essa função falhar, o retorno de chamada especificado não será cancelado. Nenhuma alteração no estado do banco de dados ocorrerá.
Comentários
A máscara de bits fornecida deve corresponder exatamente à máscara de bits especificada ao registrar o retorno de chamada. No momento, o mecanismo de banco de dados não dá suporte à remoção de um subconjunto dessas notificações e não retorna um erro quando isso é tentado.
Requisitos
Requisito | Valor |
---|---|
Cliente |
Requer o Windows Vista ou o Windows XP. |
Servidor |
Requer o Windows Server 2008 ou o Windows Server 2003. |
Cabeçalho |
Declarado em Esent.h. |
Biblioteca |
Use ESENT.lib. |
DLL |
Requer ESENT.dll. |
Consulte Também
JET_CBTYP
JET_ERR
JET_HANDLE
JET_SESID
JET_TABLEID
JetRegisterCallback
JetStopService