LPNSPV2LOOKUPSERVICENEXTEXコールバック関数 (ws2spi.h)

[アーティクル]
07/16/2024

NSPv2LookupServiceNextEx 関数は、名前空間バージョン 2 サービスプロバイダーから要求された情報を取得するために、NSPv2LookupServiceBegin への以前の呼び出しからハンドルを取得した後に呼び出されます。

構文

LPNSPV2LOOKUPSERVICENEXTEX Lpnspv2lookupservicenextex;

void Lpnspv2lookupservicenextex(
  [in]      HANDLE hAsyncCall,
  [in]      HANDLE hLookup,
  [in]      DWORD dwControlFlags,
  [in, out] LPDWORD lpdwBufferLength,
  [out]     LPWSAQUERYSET2W lpqsResults
)
{...}

パラメーター

[in] hAsyncCall

NSPv2LookupServiceBegin 前の呼び出しから返されたハンドル非同期呼び出しに使用されます。

[in] hLookup

NSPv2LookupServiceBeginをする前の呼び出しから返されたハンドル。

[in] dwControlFlags

次の操作を制御するために使用されるフラグ。現在、LUP_FLUSHPREVIOUS のみが、大きすぎる結果セットを処理する手段として定義されています。アプリケーションが十分な大きさのバッファーを提供できない場合、LUP_FLUSHPREVIOUS 設定は、最後の結果セット (大きすぎた) を破棄し、この呼び出しの次のセットに移動するようにプロバイダーに指示します。

[in, out] lpdwBufferLength

lpqsResultsによって指されるバッファーに格納されている、入力時のサイズ (バイト単位)。出力時に関数が失敗し、エラーが WSAEFAULT の場合、レコードを取得するために lpqsResults に渡す最小サイズ (バイト単位) が含まれます。

[out] lpqsResults

返されると、WSAQUERYSET2 構造体に 1 つの結果セットが格納されるメモリブロックへのポインター。

戻り値

ルーチンが成功した場合、関数は NO_ERROR (ゼロ) を返す必要があります。ルーチンが失敗し、WSASetLastErrorを使用して適切なエラーコードを設定する必要がある場合は、SOCKET_ERROR (つまり 1) 返す必要があります。

エラーコード	意味
WSA_E_CANCELLED	この呼び出しがまだ処理中 NSPv2LookupServiceEnd の呼び出しが行われました。呼び出しが取り消されました。 lpqsResults バッファー内のデータは未定義です。 Windows ソケット 2 では、WSAECANCELLED (10103) と WSA_E_CANCELLED (10111) に対して競合するエラーコードが定義されています。WSAECANCELLED エラーコードは今後のバージョンで削除され、WSA_E_CANCELLEDのみが残ります。名前空間プロバイダーは、WSA_E_CANCELLED エラーコードを使用して、可能な限り幅広いアプリケーションとの互換性を維持する必要があります。
WSA_E_NO_MORE	使用できるデータはこれ以上ありません。 Windows ソケット 2 では、WSAENOMORE (10102) と WSA_E_NO_MORE (10110) に対して競合するエラーコードが定義されています。WSAENOMORE エラーコードは将来のバージョンで削除され、WSA_E_NO_MOREのみが残ります。名前空間プロバイダーは、WSA_E_NO_MORE エラーコードを使用して、可能な限り幅広いアプリケーションとの互換性を維持する必要があります。
WSAEFAULT の	lpqsResults バッファーが小さすぎて、WSAQUERYSET セットを含めできませんでした。
WSAEINVAL の	このプロバイダーに対して 1 つ以上のパラメーターが無効であるか、不足しています。
WSA_INVALID_HANDLE	指定された参照ハンドルが無効です。
WSANO_DATA	データベース内で名前が見つかりましたが、指定された制限に一致するデータが見つかりませんでした。
WSASERVICE_NOT_FOUND	サービスが不明です。指定した名前空間にサービスが見つかりません。
WSA_NOT_ENOUGH_MEMORY	この操作を実行するのに十分なメモリがありません。

備考

NSPv2LookupServiceNextEx 関数は、Windows Vista 以降で使用できる名前空間サービスプロバイダーバージョン 2 (NSPv2) アーキテクチャの一部として使用されます。

Windows Vista および Windows Server 2008 では、NSPv2LookupServiceNextEx 関数は、NS_EMAIL名前空間プロバイダーに対する操作にのみ使用できます。

プロバイダーは、lpqsResults バッファーに WSAQUERYSET2 構造体を渡します。クライアントは、すべての WSAQUERYSET2 構造体が返されたことを示す WSA_E_NOMOREを返すまで、NSPv2LookupServiceNextEx 関数を呼び出す必要があります。

dwControlFlags この関数で指定され、NSPv2LookupServiceBegin の時点で指定されたものは、組み合わせのために "制限" として処理されます。この制限は、NSPv2LookupServiceBegin 時刻の制限と、NSPv2LookupServiceNextEx 時刻の制限との間で組み合わされます。したがって、NSPv2LookupServiceNextEx のフラグは、NSPv2LookupServiceBegin で要求されたデータ量を超えて返されるデータの量を増やすことは決してできませんが、フラグを多くまたは少なく指定してもエラーではありません。 NSPv2LookupServiceNextEx 指定されたフラグは、その呼び出しにのみ適用。

dwControlFlagsLUP_FLUSHPREVIOUS と LUP_RES_SERVICE は、結合された制限規則の例外です (これらは "制限" フラグではなく動作フラグであるため)。 NSPv2LookupServiceNextExでいずれかのフラグが使用されている場合、NSPv2LookupServiceBeginでの同じフラグの設定に関係なく、それらのフラグは定義された効果持ちます。

たとえば、LUP_RETURN_VERSION が NSPv2LookupServiceBegin指定されている場合、サービスプロバイダーはバージョンを含むレコードを取得します。 LUP_RETURN_VERSION が NSPv2LookupServiceNextEx で指定されていない場合、返される情報にはバージョンは含まれません。ただし、使用可能であった場合でも、エラーは生成されません。

また、たとえば、LUP_RETURN_BLOB が NSPv2LookupServiceBeginで指定されていないが、NSPv2LookupServiceNextEx指定されている場合、返される情報にはプライベートデータは含まれません。エラーは生成されません。

NSPv2LookupServiceNextEx 関数は、通常、少なくとも 2 回呼び出されます。 lpqsResults パラメーターが指す WSAQUERYSET2 を受け取るために必要なバッファーのサイズを初めて取得し、2 回目は実際のクエリ結果セットを取得します。最初の呼び出しでは、NSPv2 プロバイダーは、WSAQUERYSET2 結果に必要なサイズを返す必要があります。

返される lpqsResults パラメーターによって指される WSAQUERYSET2 構造体は、同じプロセスコンテキストでのみ役立ちます。これは、WSAQUERYSET2 構造体内のいくつかのメンバーに、返される実際のデータへのポインターが含まれるためです。クエリ結果を (RPC などを使用して) 別のプロセスに渡す必要がある場合は、lpqsResults パラメーターが指す WSAQUERYSET2 構造体で返されたデータをシリアル化してマーシャリングし、WSAQUERYSET2 構造体のメンバーが指すデータを含める必要があります。データは、プロセスの境界を越えて渡すことができる形式でシリアル化する必要があります。データへのポインターのみが渡され、実際のデータが他のプロセスに使用できなくなるため、WSAQUERYSET2 構造体のコピーを渡すだけでは不十分です。

クエリ結果の

次の表に、WSAQUERYSET2 の一覧と、**WSAQUERYSET2** 構造体でのクエリ結果の表現方法について説明します。詳細については、「Query-Related データ構造の」を参照してください。

メンバー名WSAQUERYSET2	結果の解釈
dwSize	WSAQUERYSET2 構造体のサイズ (バイト単位)。これはバージョン管理メカニズムとして使用されます。
lpszServiceInstanceName	サービス名を含む文字列。
lpVersion	特定のサービスインスタンスのバージョン番号を参照します。
lpszComment	サービスインスタンスによって提供されるコメント文字列。このメンバーは、NSPv2 サービスプロバイダーの要件に応じて省略可能です。
dwNameSpace	名前またはサービスインスタンスが見つかった名前空間識別子。
lpNSProviderId	このクエリ結果を提供した特定の名前空間プロバイダー。
lpszContext	サービスが配置されている階層型名前空間内のコンテキストポイント。
dwNumberOfProtocols	このメンバーは結果に対して未定義です。
lpafpProtocols	このメンバーは結果に対して未定義です。必要なすべてのプロトコル情報は、CSADDR_INFO 構造体にあります。
lpszQueryString	dwControlFlags LUP_RETURN_QUERY_STRING が含まれている場合、このメンバーは元のクエリで指定された lpszServiceInstanceName の未解析の剰余を返します。たとえば、ホスト名とそのホスト内のファイルパスを指定する階層名によってサービスを識別する名前空間では、返されるアドレスがホストアドレスで、未解析の残りがファイルパスである可能性があります。 lpszServiceInstanceName が完全に解析され、LUP_RETURN_QUERY_STRING が使用されている場合、このメンバーは null または長さ 0 の文字列を指します。
dwNumberOfCsAddrs	CSADDR_INFO 構造体の配列内の要素の数。
lpcsaBuffer	各要素内に 1 つの完全なトランスポートアドレスが含まれる、CSADDR_INFO 構造体の配列へのポインター。
dwOutputFlags	RESULT_IS_ALIAS フラグは、これがエイリアスの結果であることを示します。
lpBlob	プロバイダー固有のエンティティへのポインター。このメンバーは、NSPv2 サービスプロバイダーの要件に応じて省略可能です。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista [デスクトップアプリのみ]
サポートされる最小サーバー	Windows Server 2008 [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	ws2spi.h

メンバー名WSAQUERYSET2	結果の解釈
dwSize	WSAQUERYSET2 構造体のサイズ (バイト単位)。これはバージョン管理メカニズムとして使用されます。
lpszServiceInstanceName	サービス名を含む文字列。
lpVersion	特定のサービスインスタンスのバージョン番号を参照します。
lpszComment	サービスインスタンスによって提供されるコメント文字列。このメンバーは、NSPv2 サービスプロバイダーの要件に応じて省略可能です。
dwNameSpace	名前またはサービスインスタンスが見つかった名前空間識別子。
lpNSProviderId	このクエリ結果を提供した特定の名前空間プロバイダー。
lpszContext	サービスが配置されている階層型名前空間内のコンテキストポイント。
dwNumberOfProtocols	このメンバーは結果に対して未定義です。
lpafpProtocols	このメンバーは結果に対して未定義です。必要なすべてのプロトコル情報は、CSADDR_INFO 構造体にあります。
lpszQueryString	dwControlFlags LUP_RETURN_QUERY_STRING が含まれている場合、このメンバーは元のクエリで指定された lpszServiceInstanceName の未解析の剰余を返します。たとえば、ホスト名とそのホスト内のファイルパスを指定する階層名によってサービスを識別する名前空間では、返されるアドレスがホストアドレスで、未解析の残りがファイルパスである可能性があります。 lpszServiceInstanceName が完全に解析され、LUP_RETURN_QUERY_STRING が使用されている場合、このメンバーは null または長さ 0 の文字列を指します。
dwNumberOfCsAddrs	CSADDR_INFO 構造体の配列内の要素の数。
lpcsaBuffer	各要素内に 1 つの完全なトランスポートアドレスが含まれる、CSADDR_INFO 構造体の配列へのポインター。
dwOutputFlags	RESULT_IS_ALIAS フラグは、これがエイリアスの結果であることを示します。
lpBlob	プロバイダー固有のエンティティへのポインター。このメンバーは、NSPv2 サービスプロバイダーの要件に応じて省略可能です。

次の方法で共有

LPNSPV2LOOKUPSERVICENEXTEXコールバック関数 (ws2spi.h)

構文

パラメーター

戻り値

備考

クエリ結果の

必要条件

関連項目

フィードバック

その他のリソース