Função FltInitializeFileLock (fltkernel.h)
A rotina
Sintaxe
VOID FLTAPI FltInitializeFileLock(
[out] PFILE_LOCK FileLock
);
Parâmetros
[out] FileLock
Ponteiro para uma estrutura de FILE_LOCK não inicializada.
Valor de retorno
Nenhum
Observações
A estrutura FILE_LOCK é opaca: ou seja, seus membros são reservados para uso do sistema.
Depois de inicializada, a estrutura FILE_LOCK pode ser usada para bloquear um intervalo de bytes em um arquivo chamando FltProcessFileLock.
É um erro de programação chamar FltInitializeFileLock para uma estrutura FILE_LOCK que já foi inicializada por FltInitializeFileLock ou FltAllocateFileLock, a menos que a estrutura não tenha sido inicializada por uma chamada subsequente para FltUninitializeFileLock.
Quando a estrutura de FILE_LOCK não é mais necessária, ela pode ser não inicializada chamando FltUninitializeFileLock. A estrutura de FILE_LOCK não inicializada pode ser inicializada para reutilização chamando FltInitializeFileLock .
Para alocar e inicializar uma nova estrutura de FILE_LOCK opaca, chame FltAllocateFileLock.
Para liberar uma estrutura de FILE_LOCK inicializada, chame FltFreeFileLock .
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows XP SP2 |
| servidor com suporte mínimo | Windows Server 2003 SP1 |
| da Plataforma de Destino |
Universal |
| cabeçalho | fltkernel.h (inclua Fltkernel.h) |
| biblioteca | FltMgr.lib |
| de DLL |
Fltmgr.sys |
| IRQL | <= APC_LEVEL |