AcquirePreLicenseResponse
The AcquirePreLicenseResponse SOAP data type contains information returned from a use license acquisition attempt that used the AcquirePreLicense SOAP Web method.
Note This SOAP data type is documented as if it were used in a .NET Framework XML Web service client. For more information about creating an XML Web service client, see Building XML Web Service Clients and Accessing XML Web Services in Managed Code.
The AcquirePreLicenseResponse class is derived from the System.Object class.
Public Fields
The AcquirePreLicenseResponse class defines the following public fields.
| Field | Description |
|---|---|
| CertificateChain | Data type: XmlNode[] An array of XML nodes that contains the common licensor chain (from the server licensor certificate to the root) needed for the use licenses. |
| Licenses | Data type: XmlNode[] An array of XML nodes that contains the use licenses, index correlated to the licensee identities passed in. Each license is the leaf certificate only in the chain leading back to the root issuer. The license must be added to the CertificateChain array for a valid license chain that a client can use. |
| ReferenceCertificates | Data type: XmlNode[] This field is not currently used. |
Web Service Description Page
ServerURL/_wmcs/Licensing/License.asmx?wsdl
Remarks
This class is used by AcquirePreLicense to get a use license for one or more people by using the same issuance license. The retrieved values must be reformatted for a client to use them to acquire a use license. Reformat them in this way:
- Convert each CertificateChain value into a string array.
- Convert the corresponding Licenses value into a string value.
- Append the license as an initial element in the certificate chain array.
- Pass the resulting string array into DRMConstructCertificateChain to create a certificate chain that can be used by a AD RMS-consuming application to acquire a use license.
The actual structure of the SOAP type varies from language to language. To obtain the structure of the type, query the Web service description page.
Requirements
| Product | Requires Rights Management Services 1.0 or later. |
See Also
Acquiring the Use License
AD RMS SOAP Data Types
AcquirePreLicense
Send comments about this topic to Microsoft
Build date: 3/13/2008