partner10.transferKey

Purpose

Transfers the given Virtuozzo or HSPC Key to the specified HWID.

 

Signature

Method name: partner10.transferKey

 

Parameters

#

Type

Description

1

struct AuthInfo

requesting party authentication information

2

string

number of a key that is transferred

3

string

new hwid

 

Returns

Field

Type

Description

resultCode

int

code for command execution result (see below)

resultDesc

string

textual description of command execution result (see below)

keyNumber

string

key number. The key pattern is XXXX.XXXXXXXX.XXXX

 

Result Codes

resultCode

resultDesc

100

<key number> has been successfully transferred

200

Client authorization failed

201

Access to this method is denied

202

Access to this object is denied

220

Key <key number> is not found

221

License key <key number> is marked as problem

222

License key <key number> is terminated

223

License key <key number> is not activated

226

Another license is already active with the same HWID.

270

Transfer for license key <key number> is impossible

271

License key <key number> is temporary

300

Internal error, please try after some time

400

Incorrect authorization info format

410

Incorrect key number format: "<key number>"

414

Incorrect HWID format

 

XML Examples

Request message

<?xml version="1.0" encoding="UTF-8"?>
<methodCall>
  <methodName>partner10.transferKey</methodName>
  <params>
    <param>
      <value>
        <struct>
          <member>
            <name>login</name>
            <value>
              <string>API_LOGIN</string>
            </value>
          </member>
          <member>
            <name>password</name>
            <value>
              <string>API_PASSWORD</string>
            </value>
          </member>
        </struct>
      </value>
    </param>
    <param>
      <value>
        <string>VZ.0012345.0001</string>
      </value>
    </param>
    <param>
      <value>
        <string>2F18.9545.5634.53D9.C5B3.766A.843A.0069</string>
      </value>
    </param>
  </params>
</methodCall>

Response message

<?xml version="1.0"?>
<methodResponse>
  <params>
    <param>
      <value>
        <struct>
          <member>
            <name>resultCode</name>
            <value>
              <int>100</int>
            </value>
          </member>
          <member>
            <name>resultDesc</name>
            <value>VZ.00123456.0002 has been successfully transfered</value>
          </member>
          <member>
            <name>keyNumber</name>
            <value>VZ.00123456.0002</value>
          </member>
        </struct>
      </value>
    </param>
  </params>
</methodResponse>