CGopherConnection::CreateLocator

2011-08-09

サーバー上のファイルを検索または特定するために 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 メンバー関数を呼び出して情報の特定の部分を取り出すために、ロケーターを使用します。