PrecertifyParams class

Article
05/31/2018

[The AD RMS SDK leveraging functionality exposed by the client in Msdrm.dll is available for use in Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012, and Windows 8. It may be altered or unavailable in subsequent versions. Instead, use Active Directory Rights Management Services SDK 2.1, which leverages functionality exposed by the client in Msipc.dll.]

The PrecertifyParams SOAP data type contains information required by the PreCertify 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.

Inheritance

The AcquirePreLicenseParams class is derived from System.Object.

Members

Fields

The PrecertifyParams class has the following fields.

Field	Description
Identification	Data type: [Identification](-identification.md) An [Identification](-identification.md) object that specifies the authentication mode. This object contains the following fields: AuthenticationMode The authentication type. This field must be set to Windows. Id A security identifier (SID) for the user. Specify this value only if an email address is not specified in the UserName field. Otherwise, set this value to NULL. Email This field must be NULL. ProxyAddresses This field must be NULL. [!Note] Prior to Windows Server 2008, only the AuthenticationMode and Id fields were supported.
UserName	Data type: [String](/dotnet/api/system.string) A string value that contains the email address of the user to be certified. If this field is empty, specify a SID for the Id value of the [Identification](-identification.md) object.

Identification

Data type: [Identification](-identification.md)
An [Identification](-identification.md) object that specifies the authentication mode. This object contains the following fields:

AuthenticationMode: The authentication type. This field must be set to Windows.
Id: A security identifier (SID) for the user. Specify this value only if an email address is not specified in the UserName field. Otherwise, set this value to NULL.
Email: This field must be NULL.
ProxyAddresses: This field must be NULL.

[!Note]
Prior to Windows Server 2008, only the AuthenticationMode and Id fields were supported.

UserName

Data type: [String](/dotnet/api/system.string)
A string value that contains the email address of the user to be certified. If this field is empty, specify a SID for the Id value of the [Identification](-identification.md) object.

Web Service Description Page

ServerURL/_wmcs/Certification/Precertification.asmx?wsdl

Remarks

This class is used by the PreCertify method to acquire rights account certificates for end users. The certificates can be used to acquire end user licenses to decrypt content. 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	Rights Management Services 1.0 SP2 or later

Share via