Função FCICreate (fci.h)

Artigo
08/23/2023

A função FCICreate cria um contexto de FCI.

Sintaxe

HFCI DIAMONDAPI FCICreate(
  [in, out]      PERF              perf,
  [in]           PFNFCIFILEPLACED  pfnfcifp,
  [in]           PFNFCIALLOC       pfna,
  [in]           PFNFCIFREE        pfnf,
  [in]           PFNFCIOPEN        pfnopen,
  [in]           PFNFCIREAD        pfnread,
  [in]           PFNFCIWRITE       pfnwrite,
  [in]           PFNFCICLOSE       pfnclose,
  [in]           PFNFCISEEK        pfnseek,
  [in]           PFNFCIDELETE      pfndelete,
  [in]           PFNFCIGETTEMPFILE pfnfcigtf,
  [in]           PCCAB             pccab,
  [in, optional] void              *pv
);

Parâmetros

[in, out] perf

Ponteiro para uma estrutura ERF que recebe as informações de erro.

[in] pfnfcifp

Ponteiro para uma função de retorno de chamada definida pelo aplicativo para notificar quando um arquivo é colocado no gabinete. A função deve ser declarada usando a macro FNFCIFILEPLACED .

[in] pfna

Ponteiro para uma função de retorno de chamada definida pelo aplicativo para alocar memória. A função deve ser declarada usando a macro FNFCIALLOC .

[in] pfnf

Ponteiro para uma função de retorno de chamada definida pelo aplicativo para liberar memória alocada anteriormente. A função deve ser declarada usando a macro FNFCIFREE .

[in] pfnopen

Ponteiro para uma função de retorno de chamada definida pelo aplicativo para abrir um arquivo. A função deve ser declarada usando a macro FNFCIOPEN .

[in] pfnread

Ponteiro para uma função de retorno de chamada definida pelo aplicativo para ler dados de um arquivo. A função deve ser declarada usando a macro FNFCIREAD .

[in] pfnwrite

Ponteiro para uma função de retorno de chamada definida pelo aplicativo para gravar dados em um arquivo. A função deve ser declarada usando a macro FNFCIWRITE .

[in] pfnclose

Ponteiro para uma função de retorno de chamada definida pelo aplicativo para fechar um arquivo. A função deve ser declarada usando a macro FNFCICLOSE .

[in] pfnseek

Ponteiro para uma função de retorno de chamada definida pelo aplicativo para mover um ponteiro de arquivo para o local específico. A função deve ser declarada usando a macro FNFCISEEK .

[in] pfndelete

Ponteiro para uma função de retorno de chamada definida pelo aplicativo para excluir um arquivo. A função deve ser declarada usando a macro FNFCIDELETE .

[in] pfnfcigtf

Ponteiro para uma função de retorno de chamada definida pelo aplicativo para recuperar um nome de arquivo temporário. A função deve ser declarada usando a macro FNFCIGETTEMPFILE .

[in] pccab

Ponteiro para uma estrutura CCAB que contém os parâmetros para criar um gabinete.

[in, optional] pv

Ponteiro para um valor definido pelo aplicativo que é passado para funções de retorno de chamada.

Valor retornado

Se a função for bem-sucedida, ela retornará um ponteiro de contexto HFCI não NULL ; caso contrário, NULL.

Informações de erro estendidas são fornecidas na estrutura ERF .

Comentários

A FCI dá suporte a vários contextos simultâneos. Como resultado, é possível criar ou extrair vários gabinetes ao mesmo tempo dentro do mesmo aplicativo. Se o aplicativo for multithread, também será possível executar um contexto diferente em cada thread; no entanto, um aplicativo não pode usar o mesmo contexto simultaneamente em vários threads. Por exemplo, FCIAddFile não pode ser chamado de dois threads diferentes, usando o mesmo contexto de FCI.