SLGetSLIDList 함수(slpublic.h)

입력 쿼리 ID 형식 및 ID 값에 따라 SLID의 목록을 가져옵니다.

구문

HRESULT SLGetSLIDList(
  [in]           HSLC       hSLC,
  [in]           SLIDTYPE   eQueryIdType,
  [in, optional] const SLID *pQueryId,
  [in]           SLIDTYPE   eReturnIdType,
  [out]          UINT       *pnReturnIds,
  [out]          SLID       **ppReturnIds
);

매개 변수

[in] hSLC

형식: HSLC

현재 SLC 컨텍스트에 대한 핸들입니다.

[in] eQueryIdType

형식: SLIDTYPE

입력 ID의 형식입니다.

[in, optional] pQueryId

형식: const SLID*

입력 ID에 대한 포인터입니다.

[in] eReturnIdType

형식: SLIDTYPE

반환된 ID의 형식입니다.

[out] pnReturnIds

형식: UINT*

반환된 ID 수에 대한 포인터입니다.

[out] ppReturnIds

형식: SLID**

반환된 ID의 배열입니다.

반환 값

형식: HRESULT WINAPI

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

반환 코드/값	설명
E_INVALIDARG 0x80070057	하나 이상의 인수가 잘못되었습니다.
SL_E_VALUE_NOT_FOUND 0xC004F012	입력 키의 값을 찾을 수 없습니다.
SL_E_NOT_SUPPORT 0xC004F016	요청이 지원되지 않습니다.

설명

지원되는 쿼리 조합은 다음과 같습니다.

eQueryIdType	pQueryId	eReturnIdType	결과
SL_ID_APPLICATION	SLID_ALL	SL_ID_APPLICATION	설치된 모든 애플리케이션 ID를 가져옵니다.
SL_ID_PRODUCT_SKU	SLID_ALL	SL_ID_PRODUCT_SKU	설치된 모든 제품 SKU ID를 가져옵니다.
SL_ID_APPLICATION	appId	SL_ID_PRODUCT_SKU	입력 애플리케이션 ID에 따라 SKU ID를 가져옵니다.
SL_ID_PRODUCT_SKU	skuId	SL_ID_APPLICATION	입력 SKU ID에 따라 애플리케이션 ID를 가져옵니다.
SL_ID_PRODUCT_SKU	skuId	SL_ID_PKEY	입력 SKU ID에 따라 라이선스 PKey ID를 가져옵니다.
SL_ID_PRODUCT_SKU	skuId	SL_ID_LICENSE_FILE	입력 SKU ID에 따라 라이선스 파일 ID를 가져옵니다.
SL_ID_LICENSE_FILE	fileId	SL_ID_LICENSE	입력 라이선스 파일 ID에 따라 라이선스 ID를 가져옵니다.
SL_ID_LICENSE	LicenseId	SL_ID_LICENSE_FILE	입력 라이선스 ID에 따라 라이선스 파일 ID를 가져옵니다.
SL_ID_LICENSE	LicenseId	SL_ID_APPLICATION	토큰 활성화 라이선스의 모든 권한 부여에서 모든 애플리케이션 ID 또는 SKU ID의 통합을 가져옵니다. 라이선스 ID가 유효하지만 토큰 활성화 라이선스를 참조하지 않는 경우 SL_E_NOT_SUPPORTED 반환합니다.
SL_ID_LICENSE	LicenseId	SL_ID_PRODUCT_SKU	토큰 활성화 라이선스의 모든 권한 부여에서 모든 애플리케이션 ID 또는 SKU ID의 통합을 가져옵니다. 라이선스 ID가 유효하지만 토큰 활성화 라이선스를 참조하지 않는 경우 SL_E_NOT_SUPPORTED 반환합니다.

요구 사항

지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	slpublic.h
라이브러리	Slc.lib
DLL	Slc.dll