PathParseIconLocationA-Funktion (shlwapi.h)

Analysiert eine Dateispeicherortzeichenfolge, die einen Dateispeicherort und Symbolindex enthält, und gibt separate Werte zurück.

Syntax

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

Parameter

[in, out] pszIconFile

Typ: LPTSTR-

Ein Zeiger auf eine mit Null beendete Zeichenfolge mit Länge MAX_PATH, die eine Dateispeicherortzeichenfolge enthält. Es sollte sich in der Form "Pfad,iconindex" befinden. Wenn die Funktion zurückgegeben wird, zeigt pszIconFile- auf den Pfad der Datei.

Rückgabewert

Typ: int

Gibt den gültigen Symbolindexwert zurück.

Bemerkungen

Diese Funktion ist nützlich, um einen DefaultIcon-Wert aus der Registrierung abzurufen, indem SHGetValue und den Symbolindex vom Pfad getrennt wird.

Beispiele

#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

Anforderungen