Retrieves extended property data from a relative identifier list.
SHSTDAPI SHGetDataFromIDListA( IShellFolder *psf, PCUITEMID_CHILD pidl, int nFormat, void *pv, int cb );
A pointer to an ITEMIDLIST structure that identifies the object relative to the folder specified in psf.
The format in which the data is being requested. This parameter must be set to one of the following values.
Format used for file system objects. The pv parameter is the address of a WIN32_FIND_DATA structure.
Format used for network resources. The pv parameter is the address of a NETRESOURCE structure.
A pointer to a buffer that, when this function returns successfully, receives the requested data. The format of this buffer is determined by nFormat.
If nFormat is SHGDFIL_NETRESOURCE, there are two possible cases. If the buffer is large enough, the net resource's string information (fields for the network name, local name, provider, and comments) will be placed into the buffer. If the buffer is not large enough, only the net resource structure will be placed into the buffer and the string information pointers will be NULL.
Size of the buffer at pv, in bytes.
Returns S_OK if successful, or E_INVALIDARG otherwise.
This function extracts only information that is present in the pointer to an item identifier list (PIDL). Since the content of a PIDL depends on the folder object that created the PIDL, there is no guarantee that all requested information will be available. In addition, the information that is returned reflects the state of the object at the time the PIDL was created. The current state of the object could be different. For example, if you set nFormat to SHGDFIL_FINDDATA, the function might assign meaningful values to only some of the members of the WIN32_FIND_DATA structure. The remaining members will be set to zero. To retrieve complete current information on a file system file or folder, use standard file system functions such as GetFileTime or FindFirstFile.
E_INVALIDARG is returned if the psf, pidl, pv, or cb parameter does not match the nFormat parameter, or if nFormat is not one of the specific SHGDFIL_ values shown above.
|Minimum supported client||Windows XP [desktop apps only]|
|Minimum supported server||Windows 2000 Server [desktop apps only]|
|Header||shlobj_core.h (include Shlobj.h, Shlobj_core.h)|
|DLL||Shell32.dll (version 4.0 or later)|