다음을 통해 공유

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

서비스 테이블 관리 함수