Função PathProcessCommand (shlobj.h)

  • Artigo

Preterido. Processa uma cadeia de caracteres que contém uma linha de comando e gera uma cadeia de caracteres adequadamente entre aspas, com argumentos anexados, se necessário.

Sintaxe

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

Parâmetros

[in] pszSrc

Tipo: PCWSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém a linha de comando a ser processada.

[out] pszDest

Tipo: PWSTR

Ponteiro para um buffer que recebe uma cadeia de caracteres Unicode terminada em nulo com as aspas apropriadas. Para determinar o tamanho desse buffer, defina esse parâmetro como NULL. A função retorna o tamanho do buffer necessário.

cchDest

Tipo: int

O número máximo de caracteres que podem ser colocados em pszDest, não incluindo o caractere nulo de terminação. Se esse valor for muito pequeno, a função falhará.

dwFlags

Tipo: DWORD

Sinalizadores que controlam o procedimento. Um ou mais dos seguintes valores:

PPCF_ADDQUOTES (0x00000001)

Adicione aspas se o caminho exigir.

PPCF_ADDARGUMENTS (0x00000003)

Acrescente argumentos à direita à cadeia de caracteres de saída. Esse valor inclui PPCF_ADDQUOTES.

PPCF_NODIRECTORIES (0x00000010)

Não corresponda à cadeia de caracteres de entrada com pastas, somente com objetos de arquivo.

PPCF_FORCEQUALIFY (0x00000040)

Qualifique até mesmo nomes de arquivo não relativos.

PPCF_LONGESTPOSSIBLE (0x00000080)

Sempre escolha o nome executável mais longo possível.

Retornar valor

Tipo: LONG

Retornará um valor positivo se tiver êxito. Se lpDest for definido como NULL, a função retornará o tamanho do buffer necessário em caracteres, incluindo o caractere nulo de terminação. Se a chamada falhar, a função retornará um valor negativo.

Comentários

Nota Essa função está disponível por meio do Windows XP Service Pack 2 (SP2) e do Windows Server 2003. Não há suporte para ele no Windows Vista e versões posteriores do Windows.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj.h
Biblioteca Shell32.lib
DLL Shell32.dll (versão 5.0 ou posterior)