IShellLinkW::GetPath-Methode (shobjidl_core.h)

  • Artikel

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

Syntax

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

Parameter

[out] pszFile

Typ: LPTSTR

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

[in] cch

Typ: int

Die Größe des Puffers in Zeichen, auf den der pszFile-Parameter verweist, einschließlich des abschließenden 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 Standardmäßigen kurzen Dateinamen (Format 8.3) ab.

SLGP_UNCPRIORITY

Nicht unterstützt; nicht verwenden.

SLGP_RAWPATH

Ruft den Namen des unformatierten Pfads ab. Ein unformatierter 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)