Método IShellLinkW::GetPath (shobjidl_core.h)

Artículo
08/26/2023

Obtiene la ruta de acceso y el nombre de archivo del destino de un objeto de vínculo de Shell.

Sintaxis

HRESULT GetPath(
  [out]     LPWSTR           pszFile,
  [in]      int              cch,
  [in, out] WIN32_FIND_DATAW *pfd,
  [in]      DWORD            fFlags
);

Parámetros

[out] pszFile

Tipo: LPTSTR

Dirección de un búfer que recibe la ruta de acceso y el nombre de archivo del destino del objeto de vínculo de Shell.

[in] cch

Tipo: int

Tamaño, en caracteres, del búfer al que apunta el parámetro pszFile , incluido el carácter nulo de terminación. El tamaño máximo de ruta de acceso que se puede devolver es MAX_PATH. Este parámetro se establece normalmente mediante una llamada a ARRAYSIZE(pszFile). La macro ARRAYSIZE se define en Winnt.h.

[in, out] pfd

Tipo: WIN32_FIND_DATA*

Puntero a una estructura de WIN32_FIND_DATA que recibe información sobre el destino del objeto de vínculo shell. Si este parámetro es NULL, no se devuelve información adicional.

[in] fFlags

Tipo: DWORD

Marcas que especifican el tipo de información de ruta de acceso que se va a recuperar. Este parámetro puede ser una combinación de los valores siguientes.

SLGP_SHORTPATH

Recupera el nombre de archivo corto estándar (formato 8.3).

SLGP_UNCPRIORITY

No admitido; no use.

SLGP_RAWPATH

Recupera el nombre de ruta de acceso sin procesar. Una ruta de acceso sin procesar es algo que podría no existir y que puede incluir variables de entorno que deben expandirse.

SLGP_RELATIVEPRIORITY

Windows Vista y versiones posteriores. Recupera la ruta de acceso, si es posible, del destino del acceso directo en relación con la ruta de acceso establecida por una llamada anterior a IShellLink::SetRelativePath.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si la operación es correcta y se recupera una ruta de acceso válida. Si la operación se realiza correctamente pero no se recupera ninguna ruta de acceso, devuelve S_FALSE y pszFile estará vacía. De lo contrario, devuelve uno de los valores de error HRESULT estándar.

Requisitos

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

Compartir a través de