Purpose

Attaches specified additional Key to the main Key.

Signature

Method name: partner10.attachKey

Parameters

# Type Description
1 struct AuthInfo requesting party authentication information
2 string main key number
3 string additional key number

Returns

Field Type Description
resultCode int code for command execution result (see below)
resultDesc string textual description of command execution result (see below)

Result Codes

resultCode resultDesc
100 Additional key <additional key number> has been successfully attached to <parent key number>
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
245 Additional keytype “<additional keytype name>” not applicable to parent key’s keytype “<parent keytype name>”
277 Operation is forbidden because key <key number> conflicts with <key number>
255 Key type “<additional keytype name>” already present in key
256 Key specified by the key number is not additional key
257 Given parent key <key number> is a master key
259 Key cannot be assigned to itself
300 Internal error, please try after some time
400 Incorrect authorization info format
410 Incorrect key number format: “<key number>”

XML Examples

Request message

<?xml version="1.0" encoding="UTF-8"?>
<methodCall>
  <methodName>partner10.attachKey</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>PLSK.00123456.0000</string>
      </value>
    </param>
    <param>
      <value>
        <string>PLSK.00123457.0000</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>Additional key PLSK.00123457.0001 has been successfully attached to PLSK.00123456.0001</value>
          </member>
        </struct>
      </value>
    </param>
  </params>
</methodResponse>