CGopherConnection-Klasse

Verwaltet die Verbindung mit einem Gopherinternetserver.

Hinweis

Die Klassen CGopherConnection, CGopherFile, und CGopherLocatorCGopherFileFindihre Member sind veraltet, da sie nicht auf der Windows XP-Plattform funktionieren, aber sie arbeiten weiterhin auf früheren Plattformen.

Syntax

class CGopherConnection : public CInternetConnection

Member

Öffentliche Konstruktoren

Name	Beschreibung
CGopher Verbinden ion::CGopher Verbinden ion	Erstellt ein CGopherConnection-Objekt.

Öffentliche Methoden

Name	Beschreibung
CGopher Verbinden ion::CreateLocator	Erstellt ein CGopherLocator -Objekt, um Dateien auf einem Gopher-Server zu suchen.
CGopher Verbinden ion::GetAttribute	Ruft Attributinformationen zum Gopher-Objekt ab.
CGopher Verbinden ion::OpenFile	Öffnet eine Gopher-Datei.

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::GetGopher Verbinden ion 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 CHttp Verbinden ion und CFtp Verbinden ion.

Vererbungshierarchie

CObject

CInternet Verbinden ion

CGopherConnection

Anforderungen

Kopfzeile: afxinet.h

CGopher Verbinden ion::CGopher Verbinden ion

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 .

h Verbinden ed
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 jede Arbeit, die es tut, wird dieser Kontext-ID zugeordnet.

pstrUserName
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen des benutzers angibt, in dem sich anmelden soll. Wenn NULL, ist der Standardwert anonym.

pstrPassword
Ein Zeiger auf eine mit Null beendete Zeichenfolge, die das kennwort angibt, das zum Anmelden verwendet werden soll. 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:

pstrUserName	pstrPassword	An FTP-Server gesendeter Benutzername	An FTP-Server gesendetes Kennwort
NULL oder " "	NULL oder " "	"anonym"	E-Mail-Name des Benutzers
Zeichenfolge ungleich NULL	NULL oder " "	pstrUserName	" "
NULL-Zeichenfolge ungleich NULL	ERROR	ERROR
Zeichenfolge ungleich NULL	Zeichenfolge ungleich NULL	pstrUserName	pstrPassword

nPort
Eine Zahl, die den TCP/IP-Port identifiziert, der auf dem Server verwendet werden soll.

Hinweise

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

CGopher Verbinden ion::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 Namen des Gopherservers 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.

CGopher Verbinden ion::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.

CGopher Verbinden ion::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 CGopherConnectionCInternetSession-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