[Now Supported on Windows NT]
将文件对象或文件夹的显示名称转换为项标识符。
分析显示名称
HWND【hwndOwner】, | //处理所有者窗口 |
LPBC【// Reserved__specify NULL】, | //保留 |
LPOLESTR【lpszDisplayName】, | //指向diplay名称的指针 |
ULONG *【// Pointer to value for parsed characters】, | //指向已解析字符的值的指针 |
LPITEMIDLIST *【ppidl】, | //指向新项目标识符列表 |
ULONG *【// Address receiving attributes of file object】 | //接收文件对象的接收属性 |
); |
参数
【hwndOwner】
如果显示对话框或消息框,客户端应指定的所有者窗口的句柄。
【// Reserved__specify NULL】
Reserved; this parameter is always NULL.
【lpszDisplayName】
指向指定显示名称的以null结尾的Unicode字符串。此参数必须是解析__的显示名称,即使用SHGDN_FORPARSING值检索的显示名称。
【// Pointer to value for parsed characters】
指向一个无符号长整型值,可以接收已解析的显示名称的字符数。
【ppidl】
接收到该对象的新项目标识符列表的指针的地址。如果发生错误,则在该地址中返回NULL。
返回的项目标识符列表指定与指定显示名称相对应的相对路径(来自父文件夹)。它只包含一个SHITEMID结构,后跟一个终止零。
【// Address receiving attributes of file object】
接收文件对象的属性的地址。如果调用者不需要属性数据,则可以为NULL。
返回值
如果成功返回NOERROR,否则返回OLE定义的错误值。
备注
该方法类似于OLE定义的IParseDisplayName::ParseDisplayName方法。
也可以看看
IParseDisplayName::ParseDisplayName, IShellFolder, IShellLink, SHITEMID