Share via

SLSetGenuineInformation 함수(slpublic.h)

  • 아티클

Windows 컴퓨터의 정품 상태 대한 정보를 지정합니다.

구문

HRESULT SLSetGenuineInformation(
  [in]           const SLID *pQueryId,
  [in]           PCWSTR     pwszValueName,
  [in]           SLDATATYPE eDataType,
  [in, optional] UINT       cbValue,
  [in, optional] const BYTE *pbValue
);

매개 변수

[in] pQueryId

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

[in] pwszValueName

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

값 의미
SL_BRT_DATA
 컴퓨터의 정품 상태에 대한 정보를 설정합니다.
SL_BRT_COMMIT
 SL_BRT_DATA 값이 설정된 경우 SL_BRT_COMMIT 설정하면 컴퓨터가 비제너인 유예 기간 모드로 전환됩니다.

[in] eDataType

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

[in, optional] cbValue

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

[in, optional] pbValue

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

일부 이름-값 쌍을 사용하면 이 매개 변수가 NULL이 될 수 있습니다. 이 경우 이름-값 쌍의 기존 값이 삭제됩니다.

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

반환 값

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

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

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

반환 코드/값 설명
E_ACCESS_DENIED
0x80070005
 호출자에게 관리 권한이 없습니다.
E_INVALIDARG
0x80000003
 pbValue 매개 변수는 NULL일 수 없습니다.
(HRESULT_FROM_WIN32) ERROR_BUFFER_OVERFLOW
0x111
 pbValue 버퍼가 너무 작아서 데이터를 저장할 수 없습니다.
SL_E_DATATYPE_MISMATCHED
0xC004F01E
 pbValue 매개 변수의 데이터 형식이 eDataType 매개 변수에 지정된 형식과 일치하지 않습니다.
SL_E_DEPENDENT_PROPERTY_NOT_SET
0xC004F066
 지정된 이름-값 쌍은 설정되지 않은 이름-값 쌍에 따라 달라집니다.
SL_E_NOT_SUPPORTED
0xC004F016
 pwszValueName 매개 변수로 지정된 이름은 지원되지 않습니다.

요구 사항

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