Функция 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 определяет PathParseIconLocation в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional, Windows XP [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | shlwapi.h |
Библиотека | Shlwapi.lib |
DLL | Shlwapi.dll (версия 4.71 или более поздняя) |