FSCTL_IS_PATHNAME_VALID control code

The FSCTL_IS_PATHNAME_VALID control code performs static analysis of the supplied pathname and returns a status value that indicates whether the pathname is well formed (for example, no illegal characters, acceptable path length, and so on). Because this analysis does not consider the content of the volume, it sometimes gives "false positives." In other words, the analysis might indicate that the pathname is well formed, even when it is not. Negative results are more reliable, but are not guaranteed to be correct.

This control code is not supported with fast FAT file systems, and it is not a meaningful operation in NTFS or UDFS. NTFS and UDFS support such a wide variety of codesets that any string is potentially a valid pathname.

To perform this operation, call FltFsControlFile or ZwFsControlFile with the following parameters.

Parameters

• FileObject [in]: FltFsControlFile only. Not used.

• FileHandle [in]: FltFsControlFile only. Not used.

• FsControlCode [in]: The control code for the operation. Use FSCTL_IS_PATHNAME_VALID for this operation.

• InputBuffer [in]: A buffer that contains the NULL-terminated pathname string to check.

• InputBufferLength [in]: The length, in bytes, of the pathname.

• OutputBuffer [out]: Not used.

• OutputBufferLength [out]: Not used.

Status block

FltFsControlFile or ZwFsControlFile returns STATUS_SUCCESS if the pathname is well formed. Otherwise, the routine that is used returns the appropriate NTSTATUS error code.

Requirements