PathParseIconLocationA 函式 （shlwapi.h）

剖析包含檔案位置和圖示索引的檔案位置字串，並傳回個別的值。

語法

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

參數

[in, out] pszIconFile

類型：LPTSTR

長度為 null 的字串指標，MAX_PATH包含檔案位置字串。 其格式應該是 「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 標頭會根據 UNICODE 預處理器常數的定義，將 PathParseIconLocation 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional、Windows XP [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	shlwapi.h
連結庫	Shlwapi.lib
DLL	Shlwapi.dll （4.71 版或更新版本）