Função FCICreate (fci.h)
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.
Requisitos
| Plataforma de Destino | Windows |
| Cabeçalho | fci.h |
| Biblioteca | Cabinet.lib |
| DLL | Cabinet.dll |