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