Funzione PathProcessCommand (shlobj.h)

Articolo
03/02/2024

Deprecato. Elabora una stringa che contiene una riga di comando e genera una stringa con virgolette adattamente, con argomenti collegati se necessario.

Sintassi

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

Parametri

[in] pszSrc

Tipo: PCWSTR

Puntatore a una stringa con terminazione null contenente la riga di comando da elaborare.

[out] pszDest

Tipo: PWSTR

Puntatore a un buffer che riceve una stringa Unicode con terminazione null con le virgolette appropriate. Per determinare la dimensione di questo buffer, impostare questo parametro su NULL. La funzione restituisce le dimensioni del buffer necessarie.

cchDest

Tipo: int

Numero massimo di caratteri che possono essere inseriti in pszDest, non incluso il carattere null terminante. Se questo valore è troppo piccolo, la funzione ha esito negativo.

dwFlags

Tipo: DWORD

Contrassegna che controlla la procedura. Uno o più dei valori seguenti:

PPCF_ADDQUOTES (0x00000001)

Aggiungere virgolette se il percorso richiede.

PPCF_ADDARGUMENTS (0x00000003)

Aggiungere argomenti finali alla stringa di output. Questo valore include PPCF_ADDQUOTES.

PPCF_NODIRECTORIES (0x00000010)

Non corrispondere alla stringa di input rispetto alle cartelle, solo rispetto agli oggetti file.

PPCF_FORCEQUALIFY (0x00000040)

Qualificare anche i nomi di file non relativi.

PPCF_LONGESTPOSSIBLE (0x00000080)

Scegliere sempre il nome eseguibile più lungo possibile.

Valore restituito

Tipo: LONG

Restituisce un valore positivo se riuscito. Se lpDest è impostato su NULL, la funzione restituisce le dimensioni del buffer necessarie in caratteri, incluso il carattere Null di terminazione. Se la chiamata ha esito negativo, la funzione restituisce un valore negativo.

Commenti

Nota Questa funzione è disponibile tramite Windows XP Service Pack 2 (SP2) e Windows Server 2003. Non è supportato in Windows Vista e versioni successive di Windows.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj.h
Libreria	Shell32.lib
DLL	Shell32.dll (versione 5.0 o successiva)

Condividi tramite