Função FtpCommandW (wininet.h)

Artigo
11/20/2024

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 verdadeiro 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 sejam preenchidos.

Valor de retorno

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

Observações

GetLastError pode 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.

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

Observaçã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 ou serviços de servidor, use do Microsoft Windows HTTP Services (WinHTTP).

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wininet.h
biblioteca	Wininet.lib
de DLL	Wininet.dll

Consulte também

sessões FTP

do WinINet Functions

Compartilhar via