PKI — PKI RegistrationAuthority QUERY

The specification of the get_authority_info operation on the
RegistrationAuthority
interface does seem to has sufficient information describing the expected
semantics.
I have included the extract of the javadoc description that I have put
together based
on the spec, however, this isn't a sufficient description to implement
against.
Secondly, the method and argument names don't seem to be symmetric with the
intent of
the operation. As far as I understand, the operation "get_authority_info"
actually
serves as a post-message-get-reply operation, and the arguments
"AuthorityInfo" are
actually the messages in and out. If that's correct, then both operation
and
argument types should be renamed to imply this.

Any clarification on this would be appreciated.

/**

• Message exchange between a client entity and authority. For example
• this may provide a method for a client to determine the authentication
• policy of the authority.
  *
• @param in_authority_info The encoded message input to authority.
• @param out_authority_info The encoded returned message from
• authority.
• @return Status value.
• @exception UnsupportedTypeException
• @exception UnsupportedEncodingException
• @exception MalformedDataException
  */
  public int get_authority_info(AuthorityInfo in_authority_info,
  AuthorityInfoHolder out_authority_info)
  throws UnsupportedTypeException, UnsupportedEncodingException,
  MalformedDataException { return 0; }

see above