Função FtpGetCurrentDirectoryA (wininet.h)

Artigo
11/20/2024

Recupera o diretório atual da sessão FTP especificada.

Sintaxe

BOOL FtpGetCurrentDirectoryA(
  [in]      HINTERNET hConnect,
  [out]     LPSTR     lpszCurrentDirectory,
  [in, out] LPDWORD   lpdwCurrentDirectory
);

Parâmetros

[in] hConnect

Manipule para uma sessão FTP.

[out] lpszCurrentDirectory

Ponteiro para uma cadeia de caracteres terminada em nulo que recebe o caminho absoluto do diretório atual.

[in, out] lpdwCurrentDirectory

Ponteiro para uma variável que especifica o comprimento do buffer, em TCHARs. O comprimento do buffer deve incluir espaço para um caractere nulo de terminação. Usar um comprimento de MAX_PATH é suficiente para todos os caminhos. Quando a função retorna, a variável recebe o número de caracteres copiados para o buffer.

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

Se o buffer lpszCurrentDirectory não for grande o suficiente, lpdwCurrentDirectory receberá o número de bytes necessários para recuperar o nome completo do 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 FtpGetCurrentDirectory 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

FtpSetCurrentDirectory

do WinINet Functions

Compartilhar via