次の方法で共有

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

  • [アーティクル]

GetFirstOrderedService 関数は、テーブル内のサービスの指定されたサブセットから、指定した順序で最初のサービスを返します。

構文

PGET_FIRST_ORDERED_SERVICE PgetFirstOrderedService;

DWORD PgetFirstOrderedService(
  [in]      DWORD OrderingMethod,
  [in]      DWORD ExclusionFlags,
  [in, out] PIPX_SERVICE Service
)
{...}

パラメーター

[in] OrderingMethod

サービスを検索する順序を指定します。 このパラメーターには次のいずれかの値を指定する必要があります。

値 意味
STM_ORDER_BY_TYPE_AND_NAME
 最初にサービスを種類で検索し、次に名前で検索します。
STM_ORDER_BY_INTERFACE_TYPE_NAME
 サービスを最初にインターフェイス インデックスで検索し、次に型で検索し、最後に名前で検索します。

[in] ExclusionFlags

検査対象サービスのセットを ExclusionFlags で定義されたサブセットに制限し、 Service パラメーターによって指される構造体のメンバーの値を指定します。 使用可能なフラグの説明については、「 CreateServiceEnumerationHandle 」を参照してください。

[in, out] Service

IPX_SERVICE構造体へのポインター。

入力時に、メンバーの値は ExclusionFlags で指定されたフラグに対応します。

出力時に、指定した条件に一致する最初のサービス。

戻り値

関数が成功した場合、戻り値はNO_ERROR。

関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。

値 説明
ERROR_NO_MORE_ITEMS
 指定した条件に一致するサービスが存在しません。
ERROR_INVALID_PARAMETER
 パラメーターの 1 つが無効です。
 
 

要件

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

こちらもご覧ください

CreateServiceEnumerationHandle

IPX サービス テーブル管理

IPX_SERVICE

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