GetServerInfo method

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 GetServerInfo method retrieves an XmlNode object that contains information about an AD RMS server.

Note

This SOAP web method is documented as if it were used in a .NET Framework XML web service client. For information about creating an XML web service client, see Building XML Web Service Clients and Accessing XML Web Services in Managed Code.

Syntax

public XmlNode[] GetServerInfo(
  ServerInfoRequest[] requests
);

VB
`Public Function GetServerInfo( _ ByVal requests() As ServerInfoRequest _ ) As XmlNode()`

Parameters

requests: An array of ServerInfoRequest objects that specify the type of server information to be retrieved. Each ServerInfoRequest object contains a Type property that you can use to specify the information to return. The Type property contains one of the following values of the ServerInfoType enumeration.
VersionInfo (): Retrieves information about the server version.
ServerFeatureInfo (): Retrieves the features supported by the server.
ServerLicensorCertificate (): Retrieves the server licensor certificate.
ServiceLocations (): Retrieves the known service location for the server.

Return value

An array of XmlNode objects that contain the server information.

Web Service URL

ServerURL/_wmcs/licensing/server.asmx

ServerURL/_wmcs/certification/server.asmx

Remarks

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.

This method returns all requested information in a single server round trip.

Examples

The following example shows the XML returned in the XmlNode object when all of the types identified by the ServerInfoType enumeration are requested.

<Results xmlns="">
  <ServerInfoRequest Type="VersionInfo" AdditionalInfo="">
    <VersionInfo Version="6.0.0.0"/>
  </ServerInfoRequest>
    
  <ServerInfoRequest Type="ServerFeatureInfo" AdditionalInfo="">
    <ServerFeatureInfo>
      <Feature Name="GroupExpansionWebService" Value="true"/>
      <Feature Name="ActiveDirectoryServicesRemoting" 
               Value="false"/>
      <Feature Name="FederatedServicesEnabled" Value="0"/>
    </ServerFeatureInfo>
  </ServerInfoRequest>
    
  <ServerInfoRequest Type="ServerLicensorCertificate" 
                     AdditionalInfo="">
    <ServerLicensorCertificateChain>
      <!-- This is the same set of XmlNodes that -->
      <!-- GetServerLicensorCertificate returns. -->
        <XrML xmlns="" version="1.2">
              ...

        </XrML>
        <XrML xmlns="" version="1.2">
              ...

        </XrML>
      </ServerLicensorCertificateChain>
  </ServerInfoRequest>
    
  <ServerInfoRequest Type="ServiceLocations" AdditionalInfo="">
    <ServiceLocations>
      <ServiceLocation Type="LicensingService" 
           Url=""/>
      <ServiceLocation Type="PublishingService" 
           Url=""/>
      <ServiceLocation Type="CertificationService" 
           Url="https://localhost/_wmcs/certification/"/>
      <ServiceLocation Type="ActivationService" 
           Url="https://localhost/_wmcs/certification/"/>
      <ServiceLocation Type="PrecertificationService" 
           Url=""/>
      <ServiceLocation Type="ServerService" 
           Url=""/>
      <ServiceLocation Type="GroupExpansionService"
           Url="HTTP://localhost/_wmcs/GroupExpansion/
           GroupExpansion.asmx"/>
    </ServiceLocations>
  </ServerInfoRequest>

</Results>

Requirements


Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Product	Rights Management Services 1.0 SP2