| 术语 | shgetdatafromidlist |
| 释义 | SHGetDataFromIDList 语法： HRESULT SHGetDataFromIDList( IShellFolder *psf, PCUITEMID_CHILD pidl, int nFormat, PVOID pv, int cb ); SHGetDataFromIDList功能 检索延长至一个相对标识符列表属性数据。 参数 聚砜 父IShellFolder接口的地址。这必须是由的PIDL参数引用的ITEMIDLIST结构的直接父。 的PIDL 一个ITEMIDLIST结构，确定对象相对于涤纶短纤指定的文件夹地址。 nFormat 在该数据被请求的格式。此参数必须设置为下列值之一。 SHGDFIL_FINDDATA 格式用于文件系统对象。光伏参数是一个WIN32_FIND_DATA结构的地址。 SHGDFIL_NETRESOURCE 网络资源使用的格式。光伏参数是一个NETRESOURCE结构的地址。 SHGDFIL_DESCRIPTIONID 版本4.71。网络资源使用的格式。光伏参数是一个SHDESCRIPTIONID结构的地址。 光伏 一个缓冲区，它接收请求的数据地址。此缓冲区的格式是由nFormat。 如果nFormat是SHGDFIL_NETRESOURCE，有两种可能情况。如果缓冲区足够大，净资源的字符串信息(领域的网络名称，地方名称，提供者，和评论)将被放置到缓冲区。如果缓冲区不够大，只有净资源结构将被放置到缓冲区和字符串信息指针将为NULL。 立法会CB 大小在光伏缓冲区，以字节为单位。 返回值 如果成功返回S_OK，否则或E_INVALIDARG。 备注 此功能仅提取信息，在指针提交的项目标识符列表(的PIDL)。自1的PIDL取决于内容，但不能保证所有要求的信息将可以在文件夹对象创建的PIDL。此外，返回的信息反映的对象的PIDL在创建时的状态。对象的当前状态可以是不同的。例如，如果您设置nFormat到SHGDFIL_FINDDATA，该函数可能会指定有意义的值只对WIN32_FIND_DATA结构的一些成员。其余成员将被设置为0。要检索文件系统上的文件或文件夹的完整的最新信息，使用诸如GetFileTime或FindFirstFile标准文件系统功能。 E_INVALIDARG如果返回平方英尺，的PIDL，病菌，或cb参数不匹配nFormat参数，或者如果nFormat不是上面的具体SHGDFIL_值之一。 功能信息 最低DLL版本 shell32.dll 4.0或更高版本 自定义ImplementationNo Headershlobj.h import libraryshell32.lib 最低经营systemsWindows NT 4.0中，Windows 95中 UnicodeImplemented为ANSI和Unicode版本。 ＝＝英文原文＝＝SHGetDataFromIDList Function Retrieves extended property data from a relative identifier list. Syntax HRESULT SHGetDataFromIDList( IShellFolder *psf, PCUITEMID_CHILD pidl, int nFormat, PVOID pv, int cb ); Parameters psf The address of the parent IShellFolder interface. This must be the immediate parent of the ITEMIDLIST structure referenced by the pidl parameter. pidl The address of an ITEMIDLIST structure that identifies the object relative to the folder specified in psf. nFormat The format in which the data is being requested. This parameter must be set to one of the following values. SHGDFIL_FINDDATA Format used for file system objects. The pv parameter is the address of a WIN32_FIND_DATA structure. SHGDFIL_NETRESOURCE Format used for network resources. The pv parameter is the address of a NETRESOURCE structure. SHGDFIL_DESCRIPTIONID Version 4.71 . Format used for network resources. The pv parameter is the address of an SHDESCRIPTIONID structure. pv The address of a buffer that 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. cb Size of the buffer at pv, in bytes. Return Value Returns S_OK if successful, or E_INVALIDARG otherwise. Remarks 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. Function Information Minimum DLL Versionshell32.dll version 4.0 or later Custom ImplementationNo Headershlobj.h Import libraryshell32.lib Minimum operating systemsWindows NT 4.0, Windows 95 UnicodeImplemented as ANSI and Unicode versions. ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/bb762174(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。