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]

契約の種類。

値	説明
0	ライセンス キー パックは、ボリュームライセンス契約の選択 (250 台以上のコンピューターをお持ちのお客様向け) です。 sAgreementNumber パラメーターは、署名済み契約フォームにある登録番号 (7 桁の数字) です。
1	ライセンス キー パックは、250 台以上のコンピューターをお持ちのお客様向けの Enterprise ボリューム ライセンス契約からの製品です。 sAgreementNumber パラメーターは、署名済み契約フォームにある登録番号 (7 桁の数字) です。
2	ライセンス キー パックは、高等教育機関向けの Campus ボリューム ライセンス契約から取得したものです。 sAgreementNumber パラメーターは、署名済み契約フォームにある登録番号 (7 桁の数字) です。
3	ライセンス キー パックは、プライマリおよびセカンダリの教育機関向けの学校ボリューム ライセンス契約から取得したものです。 sAgreementNumber パラメーターは、署名済み契約フォームにある登録番号 (7 桁の数字) です。
4	ライセンス キー パックは、サービス プロバイダーが Microsoft ソフトウェアを月単位でライセンスするためのサービス プロバイダーライセンス契約のものです。 sAgreementNumber パラメーターは、署名済み契約フォームにある登録番号 (7 桁の数字) です。
5	ライセンス キー パックは、Open Value、Multi-Year Open License、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) ファイルには、Windows Management Instrumentation (WMI) クラスの定義が含まれています。 MOF ファイルは、Microsoft Windows ソフトウェア開発キット (SDK) の一部としてインストールされません。 サーバー マネージャーを使用して関連付けられたロールを追加すると、サーバーにインストールされます。 MOF ファイルの詳細については、「 マネージド オブジェクト形式 (MOF)」を参照してください。

必要条件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2008
名前空間	Root\CIMv2
MOF	TlsWmiProv.mof
[DLL]	TlsWmiProv.dll

関連項目

Win32_TSLicenseKeyPack