Fonction PathProcessCommand (shlobj.h)

Article
03/02/2024

Action déconseillée. Traite une chaîne qui contient une ligne de commande et génère une chaîne correctement citée, avec des arguments joints si nécessaire.

Syntaxe

LONG PathProcessCommand(
  [in]  PCWSTR pszSrc,
  [out] PWSTR  pszDest,
        int    cchDest,
        DWORD  dwFlags
);

Paramètres

[in] pszSrc

Type : PCWSTR

Pointeur vers une chaîne terminée par null qui contient la ligne de commande à traiter.

[out] pszDest

Type : PWSTR

Pointeur vers une mémoire tampon qui reçoit une chaîne Unicode terminée par null avec les guillemets appropriés. Pour déterminer la taille de cette mémoire tampon, définissez ce paramètre sur NULL. La fonction retourne la taille de mémoire tampon requise.

cchDest

Type : int

Nombre maximal de caractères pouvant être placés dans pszDest, sans compter le caractère null de fin. Si cette valeur est trop petite, la fonction échoue.

dwFlags

Type : DWORD

Indicateurs qui contrôlent la procédure. Une ou plusieurs des valeurs suivantes :

PPCF_ADDQUOTES (0x00000001)

Ajoutez des guillemets si le chemin d’accès les requiert.

PPCF_ADDARGUMENTS (0x00000003)

Ajoutez des arguments de fin à la chaîne de sortie. Cette valeur inclut PPCF_ADDQUOTES.

PPCF_NODIRECTORIES (0x00000010)

Ne faites pas correspondre la chaîne d’entrée aux dossiers, mais uniquement aux objets de fichier.

PPCF_FORCEQUALIFY (0x00000040)

Qualifier même les noms de fichiers non relatifs.

PPCF_LONGESTPOSSIBLE (0x00000080)

Choisissez toujours le nom d’exécutable le plus long possible.

Valeur retournée

Type : LONG

Retourne une valeur positive en cas de réussite. Si lpDest a la valeur NULL, la fonction retourne la taille de mémoire tampon requise en caractères, y compris le caractère null de fin. Si l’appel échoue, la fonction retourne une valeur négative.

Remarques

Note Cette fonction est disponible via Windows XP Service Pack 2 (SP2) et Windows Server 2003. Il n’est pas pris en charge dans Windows Vista et les versions ultérieures de Windows.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj.h
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.0 ou ultérieure)

Partager via