Partager via


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

Obtient les arguments de ligne de commande associés à un objet de lien Shell.

Syntaxe

HRESULT GetArguments(
  [out] LPSTR pszArgs,
  [in]  int   cch
);

Paramètres

[out] pszArgs

Type : LPTSTR

Pointeur vers la mémoire tampon qui, lorsque cette méthode retourne correctement, reçoit les arguments de ligne de commande.

[in] cch

Type : int

Nombre maximal de caractères pouvant être copiés dans la mémoire tampon fournie par le paramètre pszArgs . Dans le cas d’une chaîne Unicode, il n’existe aucune limitation sur la longueur maximale des chaînes. Dans le cas d’une chaîne ANSI, la longueur maximale de la chaîne retournée varie en fonction de la version de Windows, MAX_PATH antérieure à Windows 2000 et INFOTIPSIZE (définie dans Commctrl.h) dans Windows 2000 et versions ultérieures.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Dans Windows 7 et versions ultérieures, il est recommandé de récupérer les chaînes d’arguments via IPropertyStore (à l’aide de la valeur PKEY_Link_Arguments ) plutôt que cette méthode, qui peut tronquer silencieusement la chaîne si la mémoire tampon fournie n’est pas assez grande. IPropertyStore alloue une chaîne de la taille appropriée.

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)

Voir aussi

IShellLink

IShellLink ::SetArguments

IShellLinkA

IShellLinkW