Compartir a través de

Función PathProcessCommand (shlobj.h)

  • Artículo

Desusado. Procesa una cadena que contiene una línea de comandos y genera una cadena entre comillas adecuada, con argumentos adjuntos si es necesario.

Sintaxis

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

Parámetros

[in] pszSrc

Tipo: PCWSTR

Puntero a una cadena terminada en null que contiene la línea de comandos que se va a procesar.

[out] pszDest

Tipo: PWSTR

Puntero a un búfer que recibe una cadena Unicode terminada en null con las comillas adecuadas. Para determinar el tamaño que debe tener este búfer, establezca este parámetro en NULL. La función devuelve el tamaño de búfer necesario.

cchDest

Tipo: int

Número máximo de caracteres que se pueden colocar en pszDest, sin incluir el carácter nulo de terminación. Si este valor es demasiado pequeño, se produce un error en la función.

dwFlags

Tipo: DWORD

Marcas que controlan el procedimiento. Uno o varios de los siguientes valores:

PPCF_ADDQUOTES (0x00000001)

Agregue comillas si la ruta de acceso las requiere.

PPCF_ADDARGUMENTS (0x00000003)

Anexe argumentos finales a la cadena de salida. Este valor incluye PPCF_ADDQUOTES.

PPCF_NODIRECTORIES (0x00000010)

No coincida con la cadena de entrada en carpetas, solo en objetos de archivo.

PPCF_FORCEQUALIFY (0x00000040)

Calificar incluso nombres de archivo no relativos.

PPCF_LONGESTPOSSIBLE (0x00000080)

Elija siempre el nombre ejecutable más largo posible.

Valor devuelto

Tipo: LONG

Devuelve un valor positivo si se ejecuta correctamente. Si lpDest se establece en NULL, la función devuelve el tamaño de búfer necesario en caracteres, incluido el carácter nulo de terminación. Si se produce un error en la llamada, la función devuelve un valor negativo.

Comentarios

Nota Esta función está disponible a través de Windows XP Service Pack 2 (SP2) y Windows Server 2003. No se admite en Windows Vista ni en versiones posteriores de Windows.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj.h
Library Shell32.lib
Archivo DLL Shell32.dll (versión 5.0 o posterior)