CGopherConnection-Klasse

Verwaltet die Verbindung mit einem Gopherinternetserver.

Syntax

class CGopherConnection : public CInternetConnection

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Hinweise

Der Gopher-Dienst ist einer von drei Internetdiensten, die von den MFC WinInet-Klassen erkannt werden.

Die Klasse CGopherConnection enthält einen Konstruktor und drei zusätzliche Memberfunktionen, die den Gopher-Dienst verwalten: OpenFile, CreateLocator und GetAttribute.

Um mit einem Gopher-Internetserver zu kommunizieren, müssen Sie zuerst eine Instanz von CInternetSession erstellen und dann CInternetSession::GetGopherConnection aufrufen, wodurch das CGopherConnection Objekt erstellt und ein Zeiger darauf zurückgegeben wird. Sie erstellen nie direkt ein CGopherConnection Objekt.

Weitere Informationen zur CGopherConnection Funktionsweise mit den anderen MFC-Internetklassen finden Sie im Artikel "Internet Programming with WinInet". Weitere Informationen zur Verwendung der anderen beiden unterstützten Internetdienste, FTP und HTTP finden Sie unter den Klassen CHttpConnection und CFtpConnection.

Vererbungshierarchie

CObject

CInternetConnection

CGopherConnection

Anforderungen

Kopfzeile: afxinet.h

CGopherConnection::CGopherConnection

Diese Memberfunktion wird aufgerufen, um ein CGopherConnection Objekt zu erstellen.

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
Ein Zeiger auf das zugehörige CInternetSession-Objekt .

hConnected
Das Windows-Handle der aktuellen Internetsitzung.

pstrServer
Ein Zeiger auf eine Zeichenfolge, die den FTP-Servernamen enthält.

dwContext
Der Kontextbezeichner für den -Vorgang. dwContext identifiziert die Statusinformationen des Vorgangs, die von CInternetSession::OnStatusCallback zurückgegeben werden. Der Standardwert ist auf 1 festgelegt; Sie können jedoch explizit eine bestimmte Kontext-ID für den Vorgang zuweisen. Das Objekt und alle Arbeiten, die es ausführt, werden mit dieser Kontext-ID verknüpft.

pstrUserName
Zeiger auf eine nullterminierte Zeichenkette, die den Namen der Benutzerin bzw. des Benutzers angibt, die bzw. der sich anmelden soll. Wenn NULL, ist der Standardwert anonym.

pstrPassword
Ein Zeiger auf eine nullterminierte Zeichenkette, die das Kennwort für die Anmeldung angibt. Wenn sowohl pstrPassword als auch pstrUserName NULL sind, ist das standardmäßige anonyme Kennwort der E-Mail-Name des Benutzers. Wenn pstrPassword NULL (oder eine leere Zeichenfolge) ist, aber pstrUserName nicht NULL ist, wird ein leeres Kennwort verwendet. In der folgenden Tabelle wird das Verhalten für die vier möglichen Einstellungen von pstrUserName und pstrPassword beschrieben:

nPort
Eine Zahl, die den auf dem Server zu verwendenden TCP/IP-Port angibt.

Hinweise

Sie erstellen nie direkt.CGopherConnection Rufen Sie stattdessen CInternetSession::GetGopherConnection auf, das ein CGopherConnection Objekt erstellt und einen Zeiger darauf zurückgibt.

CGopherConnection::CreateLocator

Rufen Sie diese Memberfunktion auf, um einen Gopher-Locator zu erstellen, um eine Datei auf einem Gopher-Server zu suchen oder zu identifizieren.

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
Ein Zeiger auf eine Zeichenfolge, die den Namen des abzurufenden Gopher-Dokuments oder Verzeichnisses enthält. Wenn der PstrDisplayString-Parameter NULL ist, wird das Standardverzeichnis für den Gopher-Server zurückgegeben.

pstrSelectorString
Ein Zeiger auf die Selektorzeichenfolge, die an den Gopherserver gesendet werden soll, um ein Element abzurufen. pstrSelectorString kann NULL sein.

dwGopherType
Dadurch wird angegeben, ob pstrSelectorString auf ein Verzeichnis oder Dokument verweist und ob die Anforderung gopher oder gopher+ ist. Sehen Sie sich die Attribute für die Struktur GOPHER_FIND_DATA im Windows SDK an.

pstrLocator
Ein Zeiger auf eine Zeichenfolge, die die zu öffnende Datei identifiziert. Im Allgemeinen wird diese Zeichenfolge von einem Aufruf von CGopherFileFind::GetLocator zurückgegeben.

pstrServerName
Ein Zeiger auf eine Zeichenfolge, die den Gopher-Servernamen enthält.

nPort
Die Nummer, die den Internetport für diese Verbindung identifiziert.

Rückgabewert

Ein CGopherLocator-Objekt .

Hinweise

Für die statische Version der Memberfunktion müssen Sie einen Server angeben, während die nicht statische Version den Servernamen aus dem Verbindungsobjekt verwendet.

Um Informationen von einem Gopherserver abzurufen, muss eine Anwendung zuerst einen Gopher-Locator abrufen. Die Anwendung muss dann den Locator als undurchsichtiges Token behandeln (d. a. die Anwendung kann den Locator verwenden, aber nicht direkt bearbeiten oder vergleichen). Normalerweise verwendet die Anwendung den Locator für Aufrufe an die CGopherFileFind::FindFile-Memberfunktion , um eine bestimmte Informationsmenge abzurufen.

CGopherConnection::GetAttribute

Rufen Sie diese Memberfunktion auf, um bestimmte Attributinformationen zu einem Element vom Gopher-Server abzurufen.

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

Parameter

refLocator
Ein Verweis auf ein CGopherLocator-Objekt .

strRequestedAttributes
Eine durch Leerzeichen getrennte Zeichenfolge, die die Namen der angeforderten Attribute angibt.

strResult
Ein Verweis auf eine CString , die den Locator-Typ empfängt.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null). Wenn der Aufruf fehlschlägt, kann die Win32-Funktion GetLastError aufgerufen werden, um die Ursache des Fehlers zu ermitteln.

CGopherConnection::OpenFile

Rufen Sie diese Memberfunktion auf, um eine Datei auf einem Gopher-Server zu öffnen.

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

Parameter

refLocator
Ein Verweis auf ein CGopherLocator-Objekt .

dwFlags
Eine beliebige Kombination von INTERNET_FLAG_*-Flags. Weitere Informationen zu INTERNET_FLAG_*-Flags finden Sie unter CInternetSession::OpenUrl .

pstrView
Ein Zeiger auf eine Dateiansichtszeichenfolge. Wenn mehrere Ansichten der Datei auf dem Server vorhanden sind, gibt dieser Parameter an, welche Dateiansicht geöffnet werden soll. Wenn pstrView NULL ist, wird die Standarddateiansicht verwendet.

dwContext
Die Kontext-ID für die Datei, die geöffnet wird. Weitere Informationen zu dwContext finden Sie in den Hinweisen.

Rückgabewert

Ein Zeiger auf das zu öffnende CGopherFile-Objekt .

Hinweise

Überschreiben Sie den dwContext-Standardwert , um den Kontextbezeichner auf einen Wert Ihrer Wahl festzulegen. Der Kontextbezeichner ist diesem spezifischen Vorgang des Objekts zugeordnet, das von seinem CGopherConnection CInternetSession-Objekt erstellt wurde. Der Wert wird an CInternetSession::OnStatusCallback zurückgegeben, um den Status für den Vorgang bereitzustellen, mit dem er identifiziert wird. Weitere Informationen zum Kontextbezeichner finden Sie im Artikel "Internet First Steps: WinInet ".

Siehe auch

CInternetConnection-Klasse
Hierarchiediagramm
CFtpConnection-Klasse
CHttpConnection-Klasse
CInternetConnection-Klasse
CGopherLocator-Klasse
CGopherFile-Klasse
CInternetSession-Klasse