Função FtpCommandW (wininet.h)

  • Artigo

A função FtpCommand envia comandos diretamente para um servidor FTP.

Sintaxe

BOOL FtpCommandW(
  [in]  HINTERNET hConnect,
  [in]  BOOL      fExpectResponse,
  [in]  DWORD     dwFlags,
  [in]  LPCWSTR   lpszCommand,
  [in]  DWORD_PTR dwContext,
  [out] HINTERNET *phFtpCommand
);

Parâmetros

[in] hConnect

Um identificador retornado de uma chamada para InternetConnect.

[in] fExpectResponse

Um valor booliano que indica se o aplicativo espera que uma conexão de dados seja estabelecida pelo servidor FTP. Isso deve ser definido como TRUE se uma conexão de dados for esperada ou FALSE caso contrário.

[in] dwFlags

Um parâmetro que pode ser definido como um dos valores a seguir.

Valor Significado
FTP_TRANSFER_TYPE_ASCII
 Transfere o arquivo usando o método de transferência FTP ASCII (Tipo A). Os dados de controle e formatação são convertidos em equivalentes locais.
FTP_TRANSFER_TYPE_BINARY
 Transfere o arquivo usando o método de transferência de Imagem FTP (Tipo I). O arquivo é transferido exatamente sem alterações. Esse é o método de transferência padrão.

[in] lpszCommand

Um ponteiro para uma cadeia de caracteres que contém o comando a ser enviado para o servidor FTP.

[in] dwContext

Um ponteiro para uma variável que contém um valor definido pelo aplicativo usado para identificar o contexto do aplicativo em operações de retorno de chamada.

[out] phFtpCommand

Um ponteiro para um identificador criado se um soquete de dados válido for aberto. O parâmetro fExpectResponse deve ser definido como TRUE para que phFtpCommand seja preenchido.

Retornar valor

Retornará TRUE se tiver êxito ou FALSE caso contrário. Para obter uma mensagem de erro específica, chame GetLastError.

Comentários

GetLastError poderá retornar ERROR_INTERNET_NO_DIRECT_ACCESS se o aplicativo cliente estiver offline. Se um ou mais dos parâmetros forem inválidos, GetLastError retornará ERROR_INVALID_PARAMETER.

Como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro de DllMain ou dos construtores e destruidores de objetos globais.

Nota O WinINet não dá suporte a implementações de servidor. Além disso, ele não deve ser usado de um serviço. Para implementações de servidor ou serviços, use Os Serviços HTTP do Microsoft Windows (WinHTTP).
 

Observação

O cabeçalho wininet.h define FtpCommand como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [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 wininet.h
Biblioteca Wininet.lib
DLL Wininet.dll

Confira também

Sessões FTP

Funções WinINet