PathParseIconLocationA-Funktion (shlwapi.h)

Artikel
11/20/2024

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

Anmerkung

Der Header "shlwapi.h" definiert PathParseIconLocation als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 4.71 oder höher)

Freigeben über