PathParseIconLocationW, fonction (shlwapi.h)

Analyse une chaîne d’emplacement de fichier qui contient un emplacement de fichier et un index d’icône, et retourne des valeurs distinctes.

Syntaxe

int PathParseIconLocationW(
  [in, out] LPWSTR pszIconFile
);

Paramètres

[in, out] pszIconFile

Type : LPTSTR

Pointeur vers une chaîne terminée par null de longueur MAX_PATH qui contient une chaîne d’emplacement de fichier. Il doit se trouver sous la forme « path,iconindex ». Lorsque la fonction est retournée, pszIconFile pointe vers le chemin d’accès du fichier.

Valeur retournée

Type : int

Retourne la valeur d’index d’icône valide.

Remarques

Cette fonction est utile pour prendre une valeur DefaultIcon récupérée à partir du Registre par SHGetValue et séparer l’index de l’icône du chemin d’accès.

Exemples

#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

Configuration requise