What does HRESULT 0x8004255F (VDS_E_INVALID_DRIVE_LETTER_COUNT) mean?

Status / error code:

Category:

Constant name:

Source:

Facility:

Operating System:

Description:

the requested drive-letter query count is outside the valid range.

Previous	Next
VDS_E_INVALID_DRIVE_LETTER	VDS_E_INVALID_FS_FLAG

VDS_E_INVALID_DRIVE_LETTER_COUNT

VDS_E_INVALID_DRIVE_LETTER_COUNT is a parameter-contract error for drive-letter enumeration. VDS queries a contiguous range beginning with a specified letter, so the count must describe a valid range within the local alphabetic drive-letter space.

Validate the requested range before the COM call

Normalize the starting letter and reject nonalphabetic input.
Ensure that start plus count does not extend beyond the supported drive-letter range.
Use returned VDS_DRIVE_LETTER_PROP entries to determine usage instead of assuming all requested letters exist.

This error differs from a valid drive letter that is already occupied. First validate the range, then inspect the returned bUsed and volume ID fields. Configuration parsers should reject negative, zero where not permitted, overflowed or user-supplied counts before converting them to the unsigned VDS parameter.

QueryDriveLetters · Drive-letter properties · MS-VDS error codes

Looking for a different code? Search another status or error code.