CGopherConnection::CGopherConnection

Artikel
02/26/2013

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 den zugehörigen CInternetSession-Objekt.
hConnected
Das Windows-Handles der aktuellen Internet-Sitzung.
pstrServer
Ein Zeiger auf eine Zeichenfolge, die den FTP-Server-Namen enthält.
dwContext
Der Kontextbezeichner für den Vorgang.dwContext identifiziert die Statusinformationen des Vorgangs, die von CInternetSession::OnStatusCallback zurückgegeben werden.Der Standard ist auf 1 festgelegt; Sie können jedoch eine bestimmte Kontext-ID für den Vorgang explizit zuweisen.Das Objekt und alle Aufgaben, die es ausgegeben, werden mit dieser Kontext ID zugeordnet
pstrUserName
Zeiger auf eine auf NULL endende Zeichenfolge, die den Namen des Benutzers angibt, sich anzumelden.Wenn NULL, Standard anonym ist.

pstrPassword
Ein Zeiger auf eine auf NULL endende Zeichenfolge, die das Kennwort angibt, um zu verwenden, um anzumelden.Wenn pstrPassword und pstrUserNameNULL sind, ist das standardmäßige anonyme Kennwort der E-Mail-Name des Benutzers.Wenn pstrPasswordNULL (oder eine leere Zeichenfolge) ist, aber pstrUserName ist nicht NULL, wird ein leeres Kennwort verwendet.Die folgende Tabelle beschreibt das Verhalten für die vier möglichen Einstellungen von pstrUserName und von pstrPassword:

pstrUserName	pstrPassword	Benutzername an den FTP-Server	Kennwort an den FTP-Server
NULL "oder "	NULL "oder "	"anonym"	E-Mail-Name des Benutzers
Nicht NULL Zeichenfolge	NULL "oder "	pstrUserName	" "
Nicht NULL Zeichenfolge NULL	BUG	BUG
Nicht NULL Zeichenfolge	Nicht NULL Zeichenfolge	pstrUserName	pstrPassword

nPort
Eine Zahl, die den TCP/IP-Anschluss identifiziert, um auf dem Server zu verwenden.

Hinweise

Sie erstellen CGopherConnection nie direkt.Beim Aufruf CInternetSession::GetGopherConnection, der ein CGopherConnection-Objekt erstellt und einen Zeiger darauf zurückgibt.