MappingGetServices 함수(elscore.h)

아티클
02/26/2024

애플리케이션 지정 기준에 따라 연결된 정보와 함께 사용 가능한 ELS 플랫폼 지원 서비스 목록을 검색합니다.

구문

HRESULT MappingGetServices(
  [in, optional] PMAPPING_ENUM_OPTIONS pOptions,
  [out]          PMAPPING_SERVICE_INFO *prgServices,
  [out]          DWORD                 *pdwServicesCount
);

매개 변수

[in, optional] pOptions

서비스를 열거하는 동안 사용할 조건을 포함하는 MAPPING_ENUM_OPTIONS 구조체에 대한 포인터입니다. 애플리케이션은 설치된 모든 서비스를 검색하기 위해 이 매개 변수에 대해 NULL 을 지정합니다.

[out] prgServices

pOptions 매개 변수에 제공된 조건과 일치하는 서비스 정보를 포함하는 MAPPING_SERVICE_INFO 구조체 배열에 대한 포인터의 주소입니다.

[out] pdwServicesCount

이 함수가 검색된 서비스 수를 검색하는 DWORD 변수에 대한 포인터입니다.

반환 값

성공하면 S_OK 반환합니다. 함수는 성공하지 못하면 오류 HRESULT 값을 반환합니다.

참고 애플리케이션은 추가 작업을 진행하기 전에 실패를 테스트해야 합니다.

설명

ELS 애플리케이션은 모든 서비스를 검색하거나 지정된 옵션에 따라 서비스를 필터링할 수 있습니다. 연결된 프로시저 및 코드 샘플은 서비스 열거 및 해제를 참조하세요.

리소스 누수 방지를 위해 애플리케이션은 MappingFreeServices를 호출하여 prgServices로 표시된 포인터를 해제해야 합니다.

성능상의 이유로 서비스를 자주 검색하는 것이 좋습니다. 예를 들어 애플리케이션에 특정 서비스가 필요한 경우 GUID를 통해 필요할 때 열거하고 나중에 사용하기 위해 캐시할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	elscore.h
라이브러리	Elscore.lib
DLL	Elscore.dll