Compartilhar via


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

Obtém os argumentos de linha de comando associados a um objeto de link do Shell.

Sintaxe

HRESULT GetArguments(
  [out] LPSTR pszArgs,
  [in]  int   cch
);

Parâmetros

[out] pszArgs

Tipo: LPTSTR

Um ponteiro para o buffer que, quando esse método retorna com êxito, recebe os argumentos de linha de comando.

[in] cch

Tipo: int

O número máximo de caracteres que podem ser copiados para o buffer fornecido pelo parâmetro pszArgs . No caso de uma cadeia de caracteres Unicode, não há limitação no comprimento máximo da cadeia de caracteres. No caso de uma cadeia de caracteres ANSI, o comprimento máximo da cadeia de caracteres retornada varia dependendo da versão do Windows — MAX_PATH antes do Windows 2000 e INFOTIPSIZE (definido em Commctrl.h) no Windows 2000 e posterior.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

No Windows 7 e posteriores, é recomendável recuperar cadeias de caracteres de argumento embora IPropertyStore (usando o valor PKEY_Link_Arguments ) em vez desse método, que pode truncar silenciosamente a cadeia de caracteres se o buffer fornecido não for grande o suficiente. IPropertyStore aloca uma cadeia de caracteres do tamanho correto.

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)

Confira também

IShellLink

IShellLink::SetArguments

IShellLinkA

IShellLinkW