Méthode IShellLinkA ::GetPath (shobjidl_core.h)

  • Article

Obtient le chemin d’accès et le nom de fichier de la cible d’un objet de liaison Shell.

Syntaxe

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

Paramètres

[out] pszFile

Type : LPTSTR

Adresse d’une mémoire tampon qui reçoit le chemin d’accès et le nom de fichier de la cible de l’objet de liaison Shell.

[in] cch

Type : int

Taille, en caractères, de la mémoire tampon pointée vers le paramètre pszFile , y compris le caractère null de fin. La taille maximale du chemin qui peut être retournée est MAX_PATH. Ce paramètre est généralement défini en appelant ARRAYSIZE(pszFile). La macro ARRAYSIZE est définie dans Winnt.h.

[in, out] pfd

Type : WIN32_FIND_DATA*

Pointeur vers une structure WIN32_FIND_DATA qui reçoit des informations sur la cible de l’objet de liaison Shell. Si ce paramètre a la valeur NULL, aucune information supplémentaire n’est retournée.

[in] fFlags

Type : DWORD

Indicateurs qui spécifient le type d’informations de chemin d’accès à récupérer. Ce paramètre peut être une combinaison des valeurs suivantes.

SLGP_SHORTPATH

Récupère le nom de fichier court standard (format 8.3).

SLGP_UNCPRIORITY

Unsupported; n’utilisez pas.

SLGP_RAWPATH

Récupère le nom du chemin d’accès brut. Un chemin d’accès brut peut ne pas exister et peut inclure des variables d’environnement qui doivent être développées.

SLGP_RELATIVEPRIORITY

Windows Vista et versions ultérieures. Récupère le chemin d’accès, si possible, de la cible du raccourci par rapport au chemin défini par un appel précédent à IShellLink ::SetRelativePath.

Valeur retournée

Type : HRESULT

Retourne S_OK si l’opération réussit et qu’un chemin d’accès valide est récupéré. Si l’opération réussit mais qu’aucun chemin n’est récupéré, elle retourne S_FALSE et pszFile est vide. Sinon, elle retourne l’une des valeurs d’erreur HRESULT standard.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h
DLL Shell32.dll (version 4.0 ou ultérieure)