Kelas CGopherConnection

Mengelola koneksi Anda ke server Internet gopher.

Catatan

CGopherConnectionKelas , CGopherFile, CGopherFileFind, CGopherLocator dan anggota mereka tidak digunakan lagi karena mereka tidak berfungsi pada platform Windows XP, tetapi mereka akan terus bekerja pada platform sebelumnya.

Sintaks

class CGopherConnection : public CInternetConnection

Anggota

Konstruktor Publik

Nama	Deskripsi
CGopherConnection::CGopherConnection	Membuat CGopherConnection objek.

Metode Publik

Nama	Deskripsi
CGopherConnection::CreateLocator	Membuat objek CGopherLocator untuk menemukan file di server gopher.
CGopherConnection::GetAttribute	Mengambil informasi atribut tentang objek gopher.
CGopherConnection::OpenFile	Membuka file gopher.

Keterangan

Layanan gopher adalah salah satu dari tiga layanan Internet yang diakui oleh kelas MFC WinInet.

CGopherConnection Kelas berisi konstruktor dan tiga fungsi anggota tambahan yang mengelola layanan gopher: OpenFile, CreateLocator, dan GetAttribute.

Untuk berkomunikasi dengan server Internet gopher, Anda harus terlebih dahulu membuat instans CInternetSession, lalu memanggil CInternetSession::GetGopherConnection, yang membuat CGopherConnection objek dan mengembalikan pointer ke dalamnya. Anda tidak pernah membuat objek secara CGopherConnection langsung.

Untuk mempelajari selengkapnya tentang cara CGopherConnection kerja dengan kelas Internet MFC lainnya, lihat artikel Pemrograman Internet dengan WinInet. Untuk informasi selengkapnya tentang menggunakan dua layanan Internet lain yang didukung, FTP dan HTTP lihat kelas CHttpConnection dan CFtpConnection.

Hierarki Warisan

CObject

CInternetConnection

CGopherConnection

Persyaratan

Header: afxinet.h

CGopherConnection::CGopherConnection

Fungsi anggota ini dipanggil untuk membuat CGopherConnection objek.

CGopherConnection(
    CInternetSession* pSession,
    HINTERNET hConnected,
    LPCTSTR pstrServer,
    DWORD_PTR dwContext);

CGopherConnection(
    CInternetSession* pSession,
    LPCTSTR pstrServer,
    LPCTSTR pstrUserName = NULL,
    LPCTSTR pstrPassword = NULL,
    DWORD_PTR dwContext = 0,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER);

Parameter

pSession
Penunjuk ke objek CInternetSession terkait.

hConnected
Handel Windows dari sesi Internet saat ini.

pstrServer
Penunjuk ke string yang berisi nama server FTP.

dwContext
Pengidentifikasi konteks untuk operasi. dwContext mengidentifikasi informasi status operasi yang dikembalikan oleh CInternetSession::OnStatusCallback. Default diatur ke 1; namun, Anda dapat secara eksplisit menetapkan ID konteks tertentu untuk operasi tersebut. Objek dan pekerjaan apa pun yang dilakukannya akan dikaitkan dengan ID konteks tersebut.

pstrUserName
Penunjuk ke string yang dihentikan null yang menentukan nama pengguna untuk masuk. Jika NULL, defaultnya adalah anonim.

pstrPassword
Penunjuk ke string yang dihentikan null yang menentukan kata sandi yang akan digunakan untuk masuk. Jika pstrPassword dan pstrUserName adalah NULL, kata sandi anonim default adalah nama email pengguna. Jika pstrPassword adalah NULL (atau string kosong) tetapi pstrUserName bukan NULL, kata sandi kosong digunakan. Tabel berikut ini menjelaskan perilaku untuk empat kemungkinan pengaturan pstrUserName dan pstrPassword:

pstrUserName	pstrPassword	Nama pengguna dikirim ke server FTP	Kata sandi yang dikirim ke server FTP
NULL atau " "	NULL atau " "	"anonim"	Nama email pengguna
String Non-NULL	NULL atau " "	pstrUserName	" "
String NULL Non-NULL	KESALAHAN	KESALAHAN
String Non-NULL	String Non-NULL	pstrUserName	pstrPassword

nPort
Angka yang mengidentifikasi port TCP/IP untuk digunakan di server.

Keterangan

Anda tidak pernah membuat secara CGopherConnection langsung. Sebaliknya, panggil CInternetSession::GetGopherConnection, yang membuat CGopherConnection objek dan mengembalikan pointer ke objek tersebut.

CGopherConnection::CreateLocator

Panggil fungsi anggota ini untuk membuat pencari gopher untuk menemukan atau mengidentifikasi file di server gopher.

CGopherLocator CreateLocator(
    LPCTSTR pstrDisplayString,
    LPCTSTR pstrSelectorString,
    DWORD dwGopherType);

static CGopherLocator CreateLocator(LPCTSTR pstrLocator);

static CGopherLocator CreateLocator(
    LPCTSTR pstrServerName,
    LPCTSTR pstrDisplayString,
    LPCTSTR pstrSelectorString,
    DWORD dwGopherType,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER);

Parameter

pstrDisplayString
Penunjuk ke string yang berisi nama dokumen atau direktori gopher yang akan diambil. Jika parameter pstrDisplayString adalah NULL, direktori default untuk server gopher dikembalikan.

pstrSelectorString
Penunjuk ke string pemilih yang akan dikirim ke server gopher untuk mengambil item. pstrSelectorString dapat berupa NULL.

dwGopherType
Ini menentukan apakah pstrSelectorString mengacu pada direktori atau dokumen, dan apakah permintaan tersebut gopher atau gopher+. Lihat atribut untuk struktur GOPHER_FIND_DATA di Windows SDK.

pstrLocator
Penunjuk ke string yang mengidentifikasi file untuk dibuka. Umumnya, string ini dikembalikan dari panggilan ke CGopherFileFind::GetLocator.

pstrServerName
Penunjuk ke string yang berisi nama server gopher.

nPort
Nomor yang mengidentifikasi port Internet untuk sambungan ini.

Tampilkan Nilai

Objek CGopherLocator .

Keterangan

Versi statis fungsi anggota mengharuskan Anda menentukan server, sementara versi non-statis menggunakan nama server dari objek koneksi.

Untuk mengambil informasi dari server gopher, aplikasi harus terlebih dahulu mendapatkan pencari gopher. Aplikasi kemudian harus memperlakukan pencari lokasi sebagai token buram (yaitu, aplikasi dapat menggunakan pencari lokasi tetapi tidak langsung memanipulasi atau membandingkannya). Biasanya, aplikasi menggunakan pencari lokasi untuk panggilan ke fungsi anggota CGopherFileFind::FindFile untuk mengambil informasi tertentu.

CGopherConnection::GetAttribute

Panggil fungsi anggota ini untuk mengambil informasi atribut tertentu tentang item dari server gopher.

BOOL GetAttribute(
    CGopherLocator& refLocator,
    CString strRequestedAttributes,
    CString& strResult);

Parameter

refLocator
Referensi ke objek CGopherLocator .

strRequestedAttributes
String yang dibatasi spasi yang menentukan nama atribut yang diminta.

strResult
Referensi ke CString yang menerima jenis pencari lokasi.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0. Jika panggilan gagal, fungsi Win32 GetLastError dapat dipanggil untuk menentukan penyebab kesalahan.

CGopherConnection::OpenFile

Panggil fungsi anggota ini untuk membuka file di server gopher.

CGopherFile* OpenFile(
    CGopherLocator& refLocator,
    DWORD dwFlags = 0,
    LPCTSTR pstrView = NULL,
    DWORD_PTR dwContext = 1);

Parameter

refLocator
Referensi ke objek CGopherLocator .

dwFlags
Kombinasi bendera INTERNET_FLAG_*. Lihat CInternetSession::OpenUrl untuk informasi lebih lanjut tentang bendera INTERNET_FLAG_*.

pstrView
Penunjuk ke string tampilan file. Jika beberapa tampilan file ada di server, parameter ini menentukan tampilan file mana yang akan dibuka. Jika pstrView adalah NULL, tampilan file default akan digunakan.

dwContext
ID konteks untuk file yang sedang dibuka. Lihat Keterangan untuk informasi selengkapnya tentang dwContext.

Tampilkan Nilai

Penunjuk ke objek CGopherFile yang akan dibuka.

Keterangan

Ambil alih default dwContext untuk mengatur pengidentifikasi konteks ke nilai yang Anda pilih. Pengidentifikasi konteks dikaitkan dengan operasi spesifik objek yang CGopherConnection dibuat oleh objek CInternetSession ini. Nilai dikembalikan ke CInternetSession::OnStatusCallback untuk memberikan status pada operasi yang diidentifikasi. Lihat artikel Langkah Pertama Internet: WinInet untuk informasi selengkapnya tentang pengidentifikasi konteks.

Lihat juga

Kelas CInternetConnection
Bagan Hierarki
Kelas CFtpConnection
Kelas CHttpConnection
Kelas CInternetConnection
Kelas CGopherLocator
Kelas CGopherFile
Kelas CInternetSession