Metodo IShellLinkA::GetPath (shobjidl_core.h)

Articolo
03/15/2023

Ottiene il percorso e il nome del file della destinazione di un oggetto collegamento shell.

Sintassi

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

Parametri

[out] pszFile

Tipo: LPTSTR

Indirizzo di un buffer che riceve il percorso e il nome del file della destinazione dell'oggetto collegamento shell.

[in] cch

Tipo: int

Dimensioni, in caratteri, del buffer a cui punta il parametro pszFile , incluso il carattere Null di terminazione. La dimensione massima del percorso che può essere restituita è MAX_PATH. Questo parametro è comunemente impostato chiamando ARRAYSIZE(pszFile). La macro ARRAYSIZE è definita in Winnt.h.

[in, out] pfd

Tipo: WIN32_FIND_DATA*

Puntatore a una struttura WIN32_FIND_DATA che riceve informazioni sulla destinazione dell'oggetto collegamento shell. Se questo parametro è NULL, non vengono restituite informazioni aggiuntive.

[in] fFlags

Tipo: DWORD

Flag che specificano il tipo di informazioni sul percorso da recuperare. Questo parametro può essere una combinazione dei valori seguenti.

SLGP_SHORTPATH

Recupera il nome del file standard (formato 8.3).

SLGP_UNCPRIORITY

Supportato; non usare.

SLGP_RAWPATH

Recupera il nome del percorso non elaborato. Un percorso non elaborato è qualcosa che potrebbe non esistere e può includere variabili di ambiente che devono essere espanse.

SLGP_RELATIVEPRIORITY

Windows Vista e versioni successive. Recupera il percorso, se possibile, della destinazione del collegamento rispetto al percorso impostato da una chiamata precedente a IShellLink::SetRelativePath.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se l'operazione ha esito positivo e viene recuperato un percorso valido. Se l'operazione ha esito positivo, ma non viene recuperato alcun percorso, restituisce S_FALSE e pszFile sarà vuoto. In caso contrario, restituisce uno dei valori di errore HRESULT standard.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h
DLL	Shell32.dll (versione 4.0 o successiva)

Condividi tramite