CFtpConnection:: OpenFile

CInternetFile * OpenFile (LPCTSTR pstrFileName, DWORD dwAccess = GENERIC_READ, DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY, DWORD dwContext = 1);

Valor de retorno

Um ponteiro para um objeto de CInternetFile.

Parâmetros

pstrFileName

Um ponteiro para uma Cadeia de caracteres contendo o nome do arquivo a ser aberto.

dwAccess

Determina como o arquivo será acessado. Pode ser a GENERIC_READ ou GENERIC_WRITE, mas não ambos.

dwFlags

Especifica as condições sob as quais transferências subseqüentes ocorrem. Isso pode ser qualquer uma das seguintes constantes FTP_TRANSFER_ *:

dwContext

O identificador de contexto para abrir o arquivo. Consulte comentários para obter mais informações sobre como dwContext.

Observações

Chame essa função de membro para abrir um arquivo localizado em um servidor FTP para ler ou gravar. OpenFile deve ser usado nas seguintes situações:

Após chamado OpenFile e até chamar Fechar, o aplicativo só pode chamar CInternetFile:: Read, CInternetFile:: gravar, Fecharou CFtpFileFind::FindFile. Chamadas para outras funções FTP para a mesma sessão FTP irão falhar e definir o código de erro como FTP_ETRANSFER_IN_PROGRESS.

O parâmetro pstrFileName pode ser qualquer um nome de arquivo parcialmente qualificado relativo para o diretório atual ou totalmente qualificado. Uma barra invertida () ou barra (/) pode ser usada como o separador de diretório para qualquer nome. OpenFile converte os separadores de nome de diretório para os caracteres apropriados antes de usá-lo.

Substituir o padrão de dwContext para definir o identificador de contexto como um valor de sua escolha. O identificador de contexto está associado esta operação específica do objeto CFtpConnection criado pelo seu objeto de CInternetSession . O valor é retornado ao CInternetSession:: OnStatusCallback para fornecer o status sobre a operação com a qual ele é identificado. Consulte o artigo Internet primeiro etapas: WinInet para obter mais informações sobre o identificador de contexto.

Visão geral de CFtpConnection |nbsp; Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CInternetConnection, CFtpConnection::GetFile, CGopherConnection:: OpenFile, CInternetFile:: gravar, CInternetFile:: Read

Index