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。

如果函式失敗，傳回值就是下列其中一個錯誤碼。

值 Description
ERROR_NO_MORE_ITEMS
 符合指定準則的服務不存在。
ERROR_INVALID_PARAMETER
 其中一個參數無效。
 
 

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 stm.h

另請參閱

CreateServiceEnumerationHandle

IPX 服務數據表管理

IPX_SERVICE

服務數據表管理功能