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

  • Artigo

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

Sintaxe

HRESULT GetArguments(
  [out] LPWSTR 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.

Valor retornado

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 posterior, é recomendável recuperar cadeias de caracteres de argumento por 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

   
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