PIBIO_STORAGE_OPEN_DATABASE_FN função de retorno de chamada (winbio_adapter.h)

Artigo
03/03/2024

Chamado pela Estrutura Biométrica do Windows para abrir um banco de dados.

Sintaxe

PIBIO_STORAGE_OPEN_DATABASE_FN PibioStorageOpenDatabaseFn;

HRESULT PibioStorageOpenDatabaseFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [in]      PWINBIO_UUID DatabaseId,
  [in]      LPCWSTR FilePath,
  [in]      LPCWSTR ConnectString
)
{...}

Parâmetros

[in, out] Pipeline

Ponteiro para a estrutura WINBIO_PIPELINE associada à unidade biométrica que executa a operação.

[in] DatabaseId

Ponteiro para um GUID que identifica exclusivamente o banco de dados. Esse é o mesmo GUID usado para registrar o banco de dados no registro.

[in] FilePath

Ponteiro para uma cadeia de caracteres Unicode terminada em NULL que contém o caminho de arquivo totalmente qualificado para o banco de dados.

[in] ConnectString

Ponteiro para uma cadeia de conexão Unicode terminada em NULL para o banco de dados.

Retornar valor

Se a função for bem-sucedida, ela retornará S_OK. Se a função falhar, ela deverá retornar um dos seguintes valores HRESULT para indicar o erro.

Código de retorno	Descrição
E_POINTER	Um argumento de ponteiro obrigatório é NULL.
WINBIO_E_DATABASE_CANT_CREATE	O banco de dados não pode ser criado.
WINBIO_E_DATABASE_CANT_FIND	O banco de dados especificado não pode ser encontrado.
WINBIO_E_DATABASE_LOCKED	No momento, o banco de dados está bloqueado por outro aplicativo e não pode ser aberto.
WINBIO_E_DATABASE_CANT_OPEN	Um problema não especificado fez com que a solicitação falhasse.
WINBIO_E_INVALID_DEVICE_STATE	O membro StorageContext do objeto de pipeline é NULL.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winbio_adapter.h (inclua Winbio_adapter.h)

Confira também

Funções de plug-in

StorageAdapterCloseDatabase

StorageAdapterCreateDatabase

StorageAdapterEraseDatabase

Compartilhar via