AcquireTemplates method

[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 AcquireTemplates SOAP web method returns one or more AD RMS templates.

Note

This SOAP web method 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.

Syntax

public GuidTemplate[] AcquireTemplates(
  String[] guids
);

VB
Public Function AcquireTemplates( _
  ByVal guids() As String _
) As GuidTemplate()

Parameters

guids

An array of strings that contain GUIDs, one for each template. No more than 25 GUIDs can be specified for each request. That is, to retrieve more than 25 templates, you must call this method more than once. For example, to retrieve 52 templates, call this method three times, twice with 25 GUIDs and once more with 2 GUIDS.

Return value

An array of GuidTemplate objects, each of which contains a GUID, a hash of the template, and the XML template data.

Web Service URL

ServerURL/_wmcs/Licensing/TemplateDistribution.asmx

Remarks

Only active templates can be distributed by an AD RMS server. You can call the AcquireTemplateInformation method to determine the number of templates stored on the server.

Requirements

Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008

See also

AD RMS SOAP Web Methods

AcquireTemplateInformation