Export (0) Print
Expand All

GetServerInfo 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.0, 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
);


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.

ValueMeaning
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="http://localhost/_wmcs/certification/"/>
      <ServiceLocation Type="ActivationService" 
           Url="http://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

None supported

Minimum supported server

Windows Server 2008

Product

Rights Management Services 1.0 SP2

See also

AD RMS SOAP Web Methods
ServerInfoType

 

 

Show:
© 2014 Microsoft