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 成員中指定的通訊協定取得的服務。 例如，IPX_PROTOCOL_SAP DLL 通訊協定取得的服務，或路由器管理員所維護之服務的IPX_PROTOCOL_STATIC。
STM_ONLY_THIS_TYPE	只列舉與 CriteriaService服務成員中類型相同的服務

[in] CriteriaService

IPX_SERVICE 結構的指標，其成員值會對應至 ExclusionFlags 中指定的成員值。

傳回值

如果函式成功，傳回值就是與服務列舉函式搭配使用的句柄。

NULL 句柄表示指定的準則不存在任何服務，或作業失敗。 如需詳細資訊，請呼叫 GetLastError ，並針對下表檢查錯誤碼。

值	Description
ERROR_NO_SERVICES	指定的準則不存在任何服務。
ERROR_INVALID_PARAMETER	其中一個參數無效。

 

 

規格需求

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

另請參閱

CloseServiceEnumerationHandle

EnumerateGetNextService

GetLastError

IPX 服務數據表管理

IPX_SERVICE

服務數據表管理功能