CGopherConnection Sınıfı

Gopher internet sunucusuyla bağlantınızı yönetir.

Not

CGopherConnection, , CGopherFileCGopherFileFindCGopherLocator ve üyeleri, Windows XP platformunda çalışmadıkları için kullanımdan kaldırılmıştır, ancak önceki platformlarda çalışmaya devam ederler.

Sözdizimi

class CGopherConnection : public CInternetConnection

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CGopherConnection::CGopherConnection	Bir CGopherConnection nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CGopherConnection::CreateLocator	Gopher sunucusundaki dosyaları bulmak için bir CGopherLocator nesnesi oluşturur.
CGopherConnection::GetAttribute	Gopher nesnesi hakkındaki öznitelik bilgilerini alır.
CGopherConnection::OpenFile	Gopher dosyasını açar.

Açıklamalar

Gopher hizmeti, MFC WinInet sınıfları tarafından tanınan üç İnternet hizmetinden biridir.

sınıfı CGopherConnection , gopher hizmetini yöneten bir oluşturucu ve üç ek üye işlevi içerir: OpenFile, CreateLocator ve GetAttribute.

Gopher internet sunucusuyla iletişim kurmak için önce bir CInternetSession örneği oluşturmanız ve ardından CInternetSession::GetGopherConnection çağrısı yapıp nesneyi oluşturup CGopherConnection buna bir işaretçi döndürmeniz gerekir. Hiçbir zaman doğrudan nesne CGopherConnection oluşturmazsınız.

Diğer MFC İnternet sınıfları ile nasıl CGopherConnection çalıştığı hakkında daha fazla bilgi edinmek için WinInet ile İnternet Programlama makalesine bakın. Desteklenen diğer iki İnternet hizmetini kullanma hakkında daha fazla bilgi için FTP ve HTTP, CHttpConnection ve CFtpConnection sınıflarını inceleyin.

Devralma Hiyerarşisi

CObject

CInternetConnection

CGopherConnection

Gereksinimler

Üst bilgi: afxinet.h

CGopherConnection::CGopherConnection

Bu üye işlevi bir CGopherConnection nesne oluşturmak için çağrılır.

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);

Parametreler

pSession
İlgili CInternetSession nesnesinin işaretçisi .

hConnected
Geçerli İnternet oturumunun Windows tanıtıcısı.

pstrServer
FTP sunucusu adını içeren bir dize işaretçisi.

dwContext
İşlemin bağlam tanımlayıcısı. dwContext, CInternetSession::OnStatusCallback tarafından döndürülen işlemin durum bilgilerini tanımlar. Varsayılan değer 1 olarak ayarlanır; ancak, işlem için belirli bir bağlam kimliğini açıkça atayabilirsiniz. Nesnesi ve yaptığı tüm çalışmalar bu bağlam kimliğiyle ilişkilendirilecektir.

pstrUserName
Oturum açmak için kullanıcının adını belirten null ile sonlandırılan bir dize işaretçisi. NULL ise varsayılan değer anonimdir.

pstrPassword
Oturum açmak için kullanılacak parolayı belirten null ile sonlandırılan dizeye yönelik bir işaretçi. Hem pstrPassword hem de pstrUserName NULL ise, varsayılan anonim parola kullanıcının e-posta adıdır. pstrPassword NULL (veya boş bir dize) ise ancak pstrUserName NULL değilse, boş bir parola kullanılır. Aşağıdaki tabloda, pstrUserName ve pstrPassword'un dört olası ayarının davranışı açıklanmaktadır:

pstrUserName	pstrPassword	FTP sunucusuna gönderilen kullanıcı adı	FTP sunucusuna gönderilen parola
NULL veya " "	NULL veya " "	"anonim"	Kullanıcının e-posta adı
NULL Olmayan Dize	NULL veya " "	pstrUserName	" "
NULL Null Olmayan Dize	HATA	HATA
NULL Olmayan Dize	NULL Olmayan Dize	pstrUserName	pstrPassword

nPort
Sunucuda kullanılacak TCP/IP bağlantı noktasını tanımlayan bir sayı.

Açıklamalar

Hiçbir zaman doğrudan bir CGopherConnection oluşturmazsınız. Bunun yerine, CInternetSession::GetGopherConnection öğesini çağırarak bir CGopherConnection nesne oluşturur ve ona bir işaretçi döndürür.

CGopherConnection::CreateLocator

Gopher sunucusundaki bir dosyayı bulmak veya tanımlamak için gopher bulucu oluşturmak için bu üye işlevini çağır.

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);

Parametreler

pstrDisplayString
Alınacak gopher belgesinin veya dizinin adını içeren bir dize işaretçisi. pstrDisplayString parametresi NULL ise gopher sunucusunun varsayılan dizini döndürülür.

pstrSelectorString
Bir öğeyi almak için gopher sunucusuna gönderilecek seçici dizesine yönelik bir işaretçi. pstrSelectorString NULL olabilir.

dwGopherType
Bu, pstrSelectorString'in bir dizine veya belgeye başvurup başvurmayacağını ve isteğin gopher veya gopher+ olup olmadığını belirtir. Windows SDK'sında yapı GOPHER_FIND_DATA özniteliklerine bakın.

pstrLocator
Açılacak dosyayı tanımlayan bir dize işaretçisi. Bu dize genellikle CGopherFileFind::GetLocator çağrısından döndürülür.

pstrServerName
Gopher sunucu adını içeren bir dize işaretçisi.

nPort
Bu bağlantı için İnternet bağlantı noktasını tanımlayan numara.

Dönüş Değeri

CGopherLocator nesnesi.

Açıklamalar

Üye işlevinin statik sürümü bir sunucu belirtmenizi gerektirirken, statik olmayan sürüm bağlantı nesnesinden sunucu adını kullanır.

Gopher sunucusundan bilgi almak için, bir uygulamanın önce bir gopher bulucu alması gerekir. Uygulamanın daha sonra bulucuyu bir opak belirteç olarak ele alması gerekir (yani, uygulama bulucuyu kullanabilir, ancak doğrudan işleyip karşılaştırmaz). Normalde, uygulama belirli bir bilgi parçasını almak için CGopherFileFind::FindFile üye işlevine çağrılar için bulucuyu kullanır.

CGopherConnection::GetAttribute

Gopher sunucusundan bir öğe hakkında belirli öznitelik bilgilerini almak için bu üye işlevini çağırın.

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

Parametreler

refLocator
CGopherLocator nesnesine başvuru.

strRequestedAttributes
İstenen özniteliklerin adlarını belirten boşlukla ayrılmış bir dize.

strResult
Bulucu türünü alan bir CString başvurusu.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0. Çağrı başarısız olursa, hatanın nedenini belirlemek için Win32 işlevi GetLastError çağrılabilir.

CGopherConnection::OpenFile

Gopher sunucusunda bir dosya açmak için bu üye işlevini çağır.

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

Parametreler

refLocator
CGopherLocator nesnesine başvuru.

dwFlags
INTERNET_FLAG_* bayraklarının herhangi bir bileşimi. INTERNET_FLAG_* bayrakları hakkında daha fazla bilgi için bkz . CInternetSession::OpenUrl .

pstrView
Dosya görünümü dizesinin işaretçisi. Sunucuda dosyanın birkaç görünümü varsa, bu parametre hangi dosya görünümünün açılıp açılmadığını belirtir. pstrView NULL ise, varsayılan dosya görünümü kullanılır.

dwContext
Açılan dosyanın bağlam kimliği. dwContext hakkında daha fazla bilgi için bkz. Açıklamalar.

Dönüş Değeri

Açılacak CGopherFile nesnesinin işaretçisi.

Açıklamalar

Bağlam tanımlayıcısını seçtiğiniz bir değere ayarlamak için dwContext varsayılan değerini geçersiz kılın. Bağlam tanımlayıcısı, CInternetSession nesnesi tarafından oluşturulan nesnenin CGopherConnection bu özel işlemiyle ilişkilendirilir. Değer, tanımlandığı işlemde durum sağlamak için CInternetSession::OnStatusCallback'e döndürülür. Bağlam tanımlayıcısı hakkında daha fazla bilgi için İnternet İlk Adımlar: WinInet makalesine bakın.

Ayrıca bkz.

CInternetConnection Sınıfı
Hiyerarşi Grafiği
CFtpConnection Sınıfı
CHttpConnection Sınıfı
CInternetConnection Sınıfı
CGopherLocator Sınıfı
CGopherFile Sınıfı
CInternetSession Sınıfı