PCREATE_SERVICE_ENUMERATION_HANDLE コールバック関数 (stm.h)

CreateServiceEnumerationHandle 関数は、高速で変更トレラントな列挙関数を使用できるハンドルを返します。 このような関数は、すべてのサービスまたは指定されたサブセットをスキャンできます。 関数は、列挙されたサービスのセットに対して他のプロセスが加えた変更を自動的に列挙するという点で、変更トレラントです

構文

PCREATE_SERVICE_ENUMERATION_HANDLE PcreateServiceEnumerationHandle;

HANDLE PcreateServiceEnumerationHandle(
  [in] DWORD ExclusionFlags,
  [in] PIPX_SERVICE CriteriaService
)
{...}

パラメーター

[in] ExclusionFlags

CreateServiceEnumerationHandle が返す一連のサービスを、CriteriaService の対応するメンバーの ExclusionFlags と値の組み合わせによって定義されたサブセットに制限することを指定します。 このパラメーターは、次のいずれかの値です。

値	意味
STM_ONLY_THIS_INTERFACE	CriteriaService の InterfaceIndex メンバーで指定されたインターフェイスを介して取得されたサービスのみを列挙します。
STM_ONLY_THIS_PROTOCOL	CriteriaService の Protocol メンバーで指定されたプロトコルを介して取得されたサービスのみを列挙します。 たとえば、DLL プロトコルによって取得されたサービスのIPX_PROTOCOL_SAPや、ルーター マネージャーによって管理されるサービスのIPX_PROTOCOL_STATICなどです。
STM_ONLY_THIS_TYPE	CriteriaService のサービス メンバーと同じ種類のサービスのみを列挙する

[in] CriteriaService

ExclusionFlags で指定されたものに対応するメンバー値を持つIPX_SERVICE構造体へのポインター。

戻り値

関数が成功した場合、戻り値はサービス列挙関数で使用するためのハンドルです。

NULL ハンドルは、指定された条件を持つサービスが存在しないか、操作が失敗したことを示します。 詳細については、GetLastError を呼び出し、次の表に対してエラー コードをチェックします。

値	説明
ERROR_NO_SERVICES	指定された条件を持つサービスは存在しません。
ERROR_INVALID_PARAMETER	いずれかのパラメーターが無効です。

 

 

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	stm.h

こちらもご覧ください

CloseServiceEnumerationHandle

EnumerateGetNextService

GetLastError

IPX サービス テーブルの管理

IPX_SERVICE

サービス テーブル管理機能