CGopherConnection::CreateLocator

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

サーバー上のファイルを検索または特定するために 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 
);

パラメータ

pstrDisplayString
gopher カバーレターまたは取得するフォルダの名前が入っている文字列へのポインタ。pstrDisplayString パラメータが NULL の場合、gopher サーバーの既定のフォルダが返されます。
pstrSelectorString
アイテムを取得するために gopher サーバーに送られるセレクタ文字列へのポインタ。pstrSelectorString は NULL でもかまいません。
dwGopherType
pstrSelectorString がフォルダまたはカバーレターのどちらを指しているか、およびリクエストが gopher または gopher+ のどちらかを指定します。Windows SDK の GOPHER_FIND_DATA 構造体の説明を参照してください。
pstrLocator
開くファイルを指定する文字列へのポインタ。通常、この文字列は、CGopherFileFind::GetLocator の呼び出しによって返されます。
pstrServerName
gopher サーバー名が含まれている文字列へのポインタ。
nPort
現在の接続のインターネットポートを指定する番号。

戻り値

CGopherLocator オブジェクト。

解説

静的メンバ関数ではサーバーを指定する必要があります。非静的メンバ関数では、接続オブジェクトのサーバー名が使用されます。

gopher サーバーから情報を取得するには、アプリケーションは最初に gopher ロケータを取得する必要があります。その後、アプリケーションは、ロケータを不明確なトークンとして取り扱う必要があります。つまり、アプリケーションはロケータを使用できますが、直接操作または比較はできません。通常、アプリケーションは CGopherFileFind::FindFile メンバ関数を呼び出して情報の特定の部分を取り出すために、ロケータを使用します。