Expand Minimize

FltIsDirectory routine

A minifilter driver calls the FltIsDirectory routine to determine whether a given file object represents a directory.

Syntax


NTSTATUS FltIsDirectory(
  _In_   PFILE_OBJECT FileObject,
  _In_   PFLT_INSTANCE Instance,
  _Out_  PBOOLEAN IsDirectory
);

Parameters

FileObject [in]

Pointer to an already opened file object.

Instance [in]

Opaque instance pointer for the instance associated with this file object.

IsDirectory [out]

Pointer to a caller-supplied Boolean variable. On return, this variable receives TRUE if the file object represents a directory, FALSE otherwise.

Return value

FltIsDirectory returns STATUS_SUCCESS or an appropriate NTSTATUS value, such as the following:

Return codeDescription
STATUS_NOT_SUPPORTED

This error code is returned if the file system does not support stream contexts. Note that starting with Windows Vista, FltIsDirectory will return directory information even for file systems that do not support stream contexts.

 

Remarks

FltIsDirectory retrieves the desired information from the filter manager's internal stream context manager. The filter manager caches this information for future queries on this stream.

Note  This routine can only be called on an opened file object.

Requirements

Version

This routine is available on Microsoft Windows 2000 Update Rollup 1 for SP4, Windows XP SP2, Microsoft Windows Server 2003 SP1, and later. Note that this routine is not available on Windows 2000 SP4 or earlier.

Header

Fltkernel.h (include FltKernel.h)

Library

Fltmgr.lib

IRQL

<= APC_LEVEL

See also

FsRtlSupportsPerStreamContexts

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft. All rights reserved.