Share via

SLGetGenuineInformation 함수(slpublic.h)

  • 아티클

Windows 컴퓨터의 정품 상태에 대한 정보를 가져옵니다.

구문

HRESULT SLGetGenuineInformation(
  [in]            const SLID *pQueryId,
  [in]            PCWSTR     pwszValueName,
  [out, optional] SLDATATYPE *peDataType,
  [out]           UINT       *pcbValue,
  [out]           BYTE       **ppbValue
);

매개 변수

[in] pQueryId

검사 애플리케이션을 지정하는 SLID 구조체에 대한 포인터입니다.

[in] pwszValueName

검색할 값과 연결된 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 다음 이름은 유효합니다.

값 의미
SL_BRT_DATA
 컴퓨터가 정품인지 여부를 지정하는 값을 가져옵니다.
SL_BRT_COMMIT
 컴퓨터가 비제너인 유예 기간 모드인지 여부를 지정하는 값을 가져옵니다.
SL_GENUINE_RESULT
 SLAcquireGenuineTicket 함수에 대한 마지막 호출에서 반환된 값을 가져옵니다.
SL_NONGENUINE_GRACE_FLAG
 컴퓨터가 비제너인 유예 기간 모드로 전환되는 원인을 가져옵니다.

[out, optional] peDataType

ppbValue 버퍼의 데이터 형식을 지정하는 SLDATATYPE 열거형 값에 대한 포인터입니다.

[out] pcbValue

ppbValue 버퍼의 크기(바이트)에 대한 포인터입니다.

[out] ppbValue

pwszValueName 매개 변수로 지정된 이름과 연결된 값을 지정하는 BYTE 포인터 배열에 대한 포인터의 주소입니다.

이 배열 사용을 마쳤으면 LocalFree 함수를 호출하여 해제합니다.

반환 값

메서드가 성공하면 S_OK 반환합니다.

메서드가 실패하면 오류 코드가 반환됩니다. 일반적인 오류 코드 목록은 일반 HRESULT 값을 참조하세요.

이 함수는 Slerror.h에 정의된 다음 값을 반환할 수 있습니다.

반환 코드/값 설명
SL_E_NOT_SUPPORTED
0xC004F016
 pwszValueName 매개 변수로 지정된 이름은 지원되지 않습니다.
SL_E_VALUE_NOT_FOUND
0xC004F012
 지정한 이름-값 쌍을 찾을 수 없습니다.

요구 사항

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

추가 정보

SLDATATYPE

SLGetWindowsInformation