Win32_TSLicenseKeyPack 클래스의 InstallAgreementLicenseKeyPack 메서드

라이선스 계약을 통해 구매한 원격 데스크톱 서비스 라이선스 키 팩을 설치하고 인터넷을 통해 자동으로 연결하여 키 팩 라이선스의 유효성을 검사합니다.

구문

uint32 InstallAgreementLicenseKeyPack(
  [in]  uint32 AgreementType,
  [in]  string sAgreementNumber,
  [in]  uint32 ProductVersion,
  [in]  uint32 ProductType,
  [in]  uint32 LicenseCount,
  [out] uint32 KeyPackId
);

매개 변수

AgreementType [in]

규약 유형입니다.

값	Description
0	라이선스 키 팩은 볼륨 라이선스 선택 계약(컴퓨터가 250대 이상인 고객의 경우)에서 가져옵니다. sAgreementNumber 매개 변수는 서명된 계약 양식에 있는 등록 번호(7자리 숫자)입니다.
1	라이선스 키 팩은 컴퓨터가 250대 이상인 고객을 위한 엔터프라이즈 볼륨 라이선스 계약에서 가져옵니다. sAgreementNumber 매개 변수는 서명된 계약 양식에 있는 등록 번호(7자리 숫자)입니다.
2	라이선스 키 팩은 고등 교육 기관을 위한 Campus 볼륨 라이선스 계약에서 가져옵니다. sAgreementNumber 매개 변수는 서명된 계약 양식에 있는 등록 번호(7자리 숫자)입니다.
3	라이선스 키 팩은 초등 및 중등 기관을 위한 학교 볼륨 라이선스 계약에서 가져옵니다. sAgreementNumber 매개 변수는 서명된 계약 양식에 있는 등록 번호(7자리 숫자)입니다.
4	라이선스 키 팩은 서비스 공급자에 대한 서비스 공급자 사용권 계약에서 매월 Microsoft 소프트웨어 라이선스를 부여합니다. sAgreementNumber 매개 변수는 서명된 계약 양식에 있는 등록 번호(7자리 숫자)입니다.
5	라이선스 키 팩은 Open Value, 다년 오픈 라이선스 및 Open Subscription License와 같은 다른 사용권 계약에서 가져옵니다. sAgreementNumber 매개 변수는 프로그램 정보와 함께 제공되는 계약 번호입니다.

sAgreementNumber [in]

계약 번호 또는 등록 번호입니다. sAgreementNumber 매개 변수는 하이픈이 없는 7자리 숫자 문자열입니다.

ProductVersion [in]

제품 버전입니다.

값	설명
0	지원되지 않음
1	지원되지 않음
2	Windows Server 2008/Windows Server 2008 R2
4	Windows Server 2012/Windows Server 2012 R2
5	Windows Server 2016
6	Windows Server 2019

ProductType [in]

제품 유형입니다.

값	설명
0	원격 데스크톱 서비스 라이선스 키 팩 제품 유형은 디바이스당입니다. 따라서 RD 세션 호스트 서버에 연결하는 각 디바이스에는 라이선스가 있어야 합니다.
1	원격 데스크톱 서비스 라이선스 키 팩 제품 유형은 사용자 단위입니다. 따라서 RD 세션 호스트 서버에 연결하는 각 사용자에게는 라이선스가 있어야 합니다.
2	이 제품 유형이 잘못되었습니다.

LicenseCount [in]

설치할 라이선스 수입니다.

KeyPackId [out]

키 팩 식별자를 받습니다.

반환 값

메서드가 성공하면 0을 반환합니다. 메서드가 실패하면 0이 아닌 값을 반환합니다. 오류 코드 목록은 원격 데스크톱 서비스 WMI 공급자 오류 코드를 참조하세요.

설명

이 메서드를 호출하려면 Administrators 그룹의 구성원이어야 합니다.

MOF(Managed Object Format) 파일에는 WMI(Windows Management Instrumentation) 클래스에 대한 정의가 포함되어 있습니다. MOF 파일은 Microsoft Windows SDK(소프트웨어 개발 키트)의 일부로 설치되지 않습니다. 서버 관리자 사용하여 연결된 역할을 추가할 때 서버에 설치됩니다. MOF 파일에 대한 자세한 내용은 MOF(관리 개체 형식)를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2008
네임스페이스	Root\CIMv2
MOF	TlsWmiProv.mof
DLL	TlsWmiProv.dll

추가 정보

Win32_TSLicenseKeyPack