Compartilhar via

Função FtpCreateDirectoryA (wininet.h)

  • Artigo

Cria um novo diretório no servidor FTP.

Sintaxe

BOOL FtpCreateDirectoryA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszDirectory
);

Parâmetros

[in] hConnect

Identificador retornado por uma chamada anterior para InternetConnect usando INTERNET_SERVICE_FTP.

[in] lpszDirectory

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do diretório a ser criado. Esse pode ser um caminho totalmente qualificado ou um nome relativo ao diretório atual.

Retornar valor

Retorna TRUE se tiver êxito ou FALSE caso contrário. Para obter uma mensagem de erro específica, chame GetLastError. Se a mensagem de erro indicar que o servidor FTP negou a solicitação para criar um diretório, use InternetGetLastResponseInfo para determinar o motivo.

Comentários

Um aplicativo deve usar FtpGetCurrentDirectory para determinar o diretório de trabalho atual do site remoto em vez de assumir que o sistema remoto usa um esquema de nomenclatura hierárquico para diretórios.

O parâmetro lpszDirectory pode ser nomes de arquivo parcial ou totalmente qualificados em relação ao diretório atual.

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.

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

Observação

O cabeçalho wininet.h define FtpCreateDirectory 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