IShellFolder::ParseDisplayName

【勇芳软件工作室】汉化HomePreviousNext

[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