Função FtpSetCurrentDirectoryA (wininet.h)

Artigo
11/20/2024

Alterações em um diretório de trabalho diferente no servidor FTP.

Sintaxe

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

Parâmetros

[in] hConnect

Manipule para uma sessão FTP.

[in] lpszDirectory

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do diretório para se tornar o diretório de trabalho atual. Pode ser um caminho totalmente qualificado ou um nome relativo ao diretório atual.

Valor de retorno

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 alterar um diretório, use InternetGetLastResponseInfo para determinar o motivo.

Observações

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árquica para diretórios.

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

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 FtpSetCurrentDirectory 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