Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
MSDN Library
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.


Windows Mobile 6.5
A version of this page is also available for

This function retrieves information about the specified file.

BOOL GetFileInformationByHandle( 
  HANDLE hFile, 


[in] Handle to the file about which you want to obtain information.

This handle should not be a pipe handle. This function does not operate with pipe handles.


[out] Pointer to a BY_HANDLE_FILE_INFORMATION structure that receives the file information. The structure can be used in subsequent calls to this function to refer to the information about the file.

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Depending on the underlying network components of the OS and the type of server to which it is connected, this function can fail, return partial information, or full information for the specified file. In general, do not use this function unless your application runs on a limited set of OS configurations.

Windows Embedded CEWindows CE 1.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions

© 2015 Microsoft