Windows Dev Center

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.


public GuidTemplate[] AcquireTemplates(
  String[] 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



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.


Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

See also

AD RMS SOAP Web Methods



© 2015 Microsoft