.gif) |
LicenseGenerator.Get
The Get method retrieves license attribute values.
Syntax
varAttributeValue = LicenseGenerator.Get ( bstrAttributeName )
Parameters
bstrAttributeName
The name of the attribute for which you want a value. This must be one of the following values.
| Value | Description |
| Kid | The encoded key ID in the license request. The key identifier is stored in the Windows Media file, and becomes part of the challenge blob when the client requests a license. |
| Kid_decoded | The decoded key ID. |
| Client_version | The client version number. The format is x.x.x.x where x is an integer in the range zero (0) through 255. The client verification key used to verify the authenticity of the client depends on the client version number. Because the client version number is not available until after the IssueLicense method is called, you must put all possible client verification keys into the database by using the Set method. |
| Rights_issued | The rights issued to the client. This value is a hexadecimal encoding of a 4-byte number. The 32 bits represent the possible rights. |
| Expiry_date | The expiration date of the license. The format is YYYYMMDDZ, where YYYY represents a four-digit year, MM represents a two-digit month, DD represents a two-digit day, and Z indicates that the date is in universal format. |
| License_request_version | The version of the license request. The format is the same as the client version number. |
| License_version | The version number of the license issued. |
| Cert1_days_to_expiry | The number of days left before cert1 expires. |
| Cert2_days_to_expiry | The number of days left before cert2 expires. Can be either "Unused Cert" or an integer. |
Return Values
This method returns a Variant containing the value of the attribute. If it fails, it returns a number in the error object.
Remarks
You can use the attribute values, with or without a database, to make decisions regarding whether to issue the license.
Requirements
Version: Windows Media Rights Manager 7 SDK or later
Reference: LicenseServer 1.0 Type Library
Library: licenseserver.dll
Platform: Windows Server 2003
See Also