Función FltDeleteFileContext (fltkernel.h)

Artículo
08/07/2023

La rutina FltDeleteFileContext recupera y elimina un contexto de archivo que un controlador de minifiltro determinado ha establecido para un archivo determinado.

Sintaxis

NTSTATUS FLTAPI FltDeleteFileContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *OldContext
);

Parámetros

[in] Instance

Puntero de instancia opaco para el autor de la llamada. Este parámetro es obligatorio y no puede ser NULL.

[in] FileObject

Puntero de objeto de archivo para el archivo. Este parámetro es obligatorio y no puede ser NULL.

[out] OldContext

Puntero a una variable asignada por el autor de la llamada que recibe la dirección del contexto eliminado. Si no se encuentra ningún contexto coincidente, esta variable recibe NULL_CONTEXT. Este parámetro es opcional y puede ser NULL. Para obtener más información sobre este parámetro, vea la siguiente sección Comentarios.

Valor devuelto

FltDeleteFileContext devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como uno de los siguientes:

Código devuelto	Descripción
STATUS_NOT_FOUND	No se encontró ningún contexto coincidente. Se trata de un código de error.
STATUS_NOT_SUPPORTED	No se admiten contextos de archivo para este archivo. Se trata de un código de error.

Comentarios

Para obtener más información sobre los contextos, vea Acerca de los contextos de minifiltro.

Dado que los contextos son contadas por referencias, normalmente no es necesario que un controlador de minifiltro llame a una rutina como FltDeleteFileContext o FltDeleteContext para eliminar explícitamente un contexto.

Un controlador de minifiltro llama a FltDeleteFileContext para recuperar y eliminar un contexto de archivo que estableció anteriormente para un archivo mediante una llamada a FltSetFileContext.

Si el parámetro OldContext es NULL en la entrada y se encuentra un contexto de archivo coincidente, FltDeleteFileContext libera la referencia agregada por la llamada anterior del controlador minifiltro a FltSetFileContext. Normalmente, el contexto eliminado se libera inmediatamente a menos que haya una referencia pendiente en él (por ejemplo, porque otro subproceso sigue usando el contexto).

Si el parámetro OldContext no es NULL y se encuentra y devuelve un contexto de archivo coincidente, el autor de la llamada es responsable de liberar la referencia que ha agregado FltSetFileContext. Para liberar esta referencia, el controlador de minifiltro debe llamar a FltReleaseContext en el contexto de archivo eliminado tan pronto como sea posible después de realizar cualquier limpieza necesaria.

Para asignar un nuevo contexto, llame a FltAllocateContext.

Para determinar si se admiten contextos de archivo para un archivo determinado, llame a FltSupportsFileContexts o FltSupportsFileContextsEx.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista y versiones posteriores
Plataforma de destino	Universal
Encabezado	fltkernel.h (incluya Fltkernel.h)
Library	FltMgr.lib
IRQL	<= APC_LEVEL