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의 프로토콜 멤버에 지정된 프로토콜을 통해 얻은 서비스만 열거합니다. 예를 들어 IPX_PROTOCOL_SAP DLL 프로토콜에서 가져온 서비스 또는 라우터 관리자가 유지 관리하는 서비스에 대한 IPX_PROTOCOL_STATIC.
STM_ONLY_THIS_TYPE	CriteriaService의 서비스 멤버와 형식이 동일한 서비스만 열거합니다.

[in] CriteriaService

ExclusionFlags에 지정된 값에 해당하는 멤버 값이 있는 IPX_SERVICE 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값은 서비스 열거형 함수에 사용할 핸들입니다.

NULL 핸들은 지정된 조건을 가진 서비스가 없거나 작업이 실패했음을 나타냅니다. 자세한 내용은 GetLastError를 호출하고 아래 표에 대한 오류 코드를 검사.

값	Description
ERROR_NO_SERVICES	지정된 조건을 가진 서비스가 없습니다.
ERROR_INVALID_PARAMETER	매개 변수 중 하나가 잘못되었습니다.

 

 

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	stm.h

추가 정보

CloseServiceEnumerationHandle

EnumerateGetNextService

GetLastError

IPX 서비스 테이블 관리

IPX_SERVICE

서비스 테이블 관리 함수