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
只列舉透過 CriteriaServiceProtocol 成員中指定的通訊協定取得的服務。 例如,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

服務數據表管理功能