PathParseIconLocationA 函数 (shlwapi.h)

分析包含文件位置和图标索引的文件位置字符串,并返回单独的值。

语法

int PathParseIconLocationA(
  [in, out] LPSTR pszIconFile
);

参数

[in, out] pszIconFile

类型:LPTSTR

指向长度为 null 的字符串的指针,MAX_PATH包含文件位置字符串。 它应采用“路径iconindex”的形式。 函数返回时,pszIconFile 将指向文件的路径。

返回值

类型:int

返回有效的图标索引值。

言论

此函数可用于获取从注册表检索的 DefaultIcon 值,方法是 SHGetValue 并将图标索引与路径分隔开来。

例子

#include <windows.h>
#include <iostream.h>
#include "Shlwapi.h"

void main(void)
{
// Path to parse for file and icon index.
char buffer_1[ ] = "C:\\TEST\\sample.txt,3"; 
char *lpStr1;
lpStr1 = buffer_1;

// Return value from "PathParseIconLocation".
int retval;

// Search a path to parse for file and icon index.
retval = PathParseIconLocation(lpStr1);
cout << "The path to parse for file and icon index is   : " << lpStr1 << endl;
cout << "PathParseIconLocation returns the icon index of: " << retval << endl;
}

OUTPUT:
==========
The path to parse for file and icon index is   : C:\TEST\sample.txt
PathParseIconLocation returns the icon index of: 3

注意

shlwapi.h 标头将 PathParseIconLocation 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional、Windows XP [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 shlwapi.h
Shlwapi.lib
DLL Shlwapi.dll(版本 4.71 或更高版本)