CRMLicense.CheckValidLicenseCombination Method

  • Article

The CheckValidLicenseCombination method checks whether the specified software license combination is valid for a user.

Syntax

[Visual Basic .NET]
Public Function CheckValidLicenseCombination(
  ByVal LicenseArray As String()
) As Integer
[C#]
public int CheckValidLicenseCombination(
  string[]  LicenseArray
);
[C++]
public: long CheckValidLicenseCombination(
  String*  LicenseArray __gc[]
);

Parameters

LicenseArray

Specifies an array of license IDs. See License Names for the set of license IDs.

Return Value

Returns an Int32 type that is 1 if the software license combination is valid or is 0 if the license combination is not valid.

Remarks

If there is an error, SOAP throws an exception and the error message is reported in System.Web.Services.Protocols.SoapException.Detail.OuterXml.

All IDs passed to the platform are GUIDs wrapped in braces. For example: {6522D89A-A752-4455-A2B0-51494C6957C3}

Example

[C#]
// strServer should be set with the name of the platform Web server
string strServer = "myservername";

// virtualDirectory should be set with the name of the Microsoft CRM
// virtual directory on the platform Web server
string virtualDirectory = "mscrmservices";
string strDir = "https://" + strServer + "/" + virtualDirectory + "/";

// BizUser proxy object
Microsoft.CRM.Proxy.BizUser bizUser = new Microsoft.CRM.Proxy.BizUser ();
bizUser.Credentials = System.Net.CredentialCache.DefaultCredentials;
bizUser.Url = strDir + "BizUser.srf";

// CRMLicense proxy object
Microsoft.CRM.Proxy.CRMLicense license = new Microsoft.CRM.Proxy.CRMLicense();
license.Credentials = System.Net.CredentialCache.DefaultCredentials;
license.Url = strDir + "CRMLicense.srf";

string strErrorMsg = "";
string[] vlicense = new String[2] 
      {   
         "{C000EA1A-6343-4F78-BB38-4D00636BB70B}",   // Standard CS
         "{4F32A556-8B6A-4937-B94D-E5117C70C614}"   // Standard SFA
      };   

int vlicenseCount = -1;

try
{
   Microsoft.CRM.Proxy.CUserAuth userAuth = bizUser.WhoAmI();
   
   vlicenseCount = license.CheckValidLicenseCombination(vlicense);
}
catch (System.Web.Services.Protocols.SoapException err)
{
   // Process the platform error here
   strErrorMsg = ("ErrorMessage: " + err.Message + " " + err.Detail.OuterXml + " Source: " + err.Source );
}
catch (Exception err)
{
   // Process other errors here
   strErrorMsg = ("ErrorMessage: " + err.Message );
}

Requirements

Namespace: Microsoft.CRM.Proxy

Assembly: microsoft.crm.proxy.dll

See Also

© 2003 Microsoft Corporation. All rights reserved.