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

  • Artigo

Obtém o caminho e o nome do arquivo do destino de um objeto de link do Shell.

Sintaxe

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

Parâmetros

[out] pszFile

Tipo: LPTSTR

O endereço de um buffer que recebe o caminho e o nome do arquivo do destino do objeto de link do Shell.

[in] cch

Tipo: int

O tamanho, em caracteres, do buffer apontado pelo parâmetro pszFile , incluindo o caractere nulo de terminação. O tamanho máximo do caminho que pode ser retornado é MAX_PATH. Esse parâmetro é normalmente definido chamando ARRAYSIZE(pszFile). A macro ARRAYSIZE é definida em Winnt.h.

[in, out] pfd

Tipo: WIN32_FIND_DATA*

Um ponteiro para uma estrutura WIN32_FIND_DATA que recebe informações sobre o destino do objeto de link do Shell. Se esse parâmetro for NULL, nenhuma informação adicional será retornada.

[in] fFlags

Tipo: DWORD

Sinalizadores que especificam o tipo de informações de caminho a serem recuperadas. Esse parâmetro pode ser uma combinação dos seguintes valores.

SLGP_SHORTPATH

Recupera o nome de arquivo curto padrão (formato 8.3).

SLGP_UNCPRIORITY

Unsupported; não use.

SLGP_RAWPATH

Recupera o nome do caminho bruto. Um caminho bruto é algo que pode não existir e pode incluir variáveis de ambiente que precisam ser expandidas.

SLGP_RELATIVEPRIORITY

Windows Vista e posterior. Recupera o caminho, se possível, do destino do atalho em relação ao caminho definido por uma chamada anterior para IShellLink::SetRelativePath.

Retornar valor

Tipo: HRESULT

Retorna S_OK se a operação for bem-sucedida e um caminho válido for recuperado. Se a operação for bem-sucedida, mas nenhum caminho for recuperado, ela retornará S_FALSE e pszFile estará vazio. Caso contrário, ele retornará um dos valores de erro HRESULT padrão.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [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 shobjidl_core.h
DLL Shell32.dll (versão 4.0 ou posterior)