IShellLinkA::GetPath-Methode (shobjidl_core.h)

Artikel
03/04/2024

Ruft den Pfad und dateinamen des Ziels eines Shell-Linkobjekts ab.

Syntax

HRESULT GetPath(
  [out]     LPSTR            pszFile,
  [in]      int              cch,
  [in, out] WIN32_FIND_DATAA *pfd,
  [in]      DWORD            fFlags
);

Parameter

[out] pszFile

Typ: LPTSTR

Die Adresse eines Puffers, der den Pfad und den Dateinamen des Ziels des Shell-Linkobjekts empfängt.

[in] cch

Typ: int

Die Größe des Puffers in Zeichen, auf den der parameter pszFile verweist, einschließlich des beendenden NULL-Zeichens. Die maximale Pfadgröße, die zurückgegeben werden kann, ist MAX_PATH. Dieser Parameter wird in der Regel durch Aufrufen von ARRAYSIZE(pszFile) festgelegt. Das ARRAYSIZE-Makro ist in Winnt.h definiert.

[in, out] pfd

Typ: WIN32_FIND_DATA*

Ein Zeiger auf eine WIN32_FIND_DATA-Struktur , die Informationen über das Ziel des Shell-Linkobjekts empfängt. Wenn dieser Parameter NULL ist, werden keine zusätzlichen Informationen zurückgegeben.

[in] fFlags

Art: DWORD

Flags, die den Typ der abzurufenden Pfadinformationen angeben. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.

SLGP_SHORTPATH

Ruft den Kurzen Standarddateinamen (8.3-Format) ab.

SLGP_UNCPRIORITY

Nicht unterstützt; nicht verwenden.

SLGP_RAWPATH

Ruft den Namen des rohen Pfads ab. Ein roher Pfad ist möglicherweise nicht vorhanden und kann Umgebungsvariablen enthalten, die erweitert werden müssen.

SLGP_RELATIVEPRIORITY

Windows Vista und höher. Ruft nach Möglichkeit den Pfad des Ziels der Verknüpfung relativ zum Pfad ab, der durch einen vorherigen Aufruf von IShellLink::SetRelativePath festgelegt wurde.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn der Vorgang erfolgreich ist und ein gültiger Pfad abgerufen wird. Wenn der Vorgang erfolgreich ist, aber kein Pfad abgerufen wird, wird S_FALSE zurückgegeben, und pszFile ist leer. Andernfalls wird einer der HRESULT-Standardfehlerwerte zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h
DLL	Shell32.dll (Version 4.0 oder höher)

Freigeben über