IDKYPA   

Equivalent PK functions:

IDKYPA ( keylen, key, parts, states, nparts, ifail )
====================================================

  Identify keyed parts.

Receives:
  KI_int_nchars            *keylen         --- length of key
  KI_chr_key                key[keylen]    --- key of part to find

Returns:
  KI_tag_list_part         *parts          --- parts found with given key
  KI_tag_list_int          *states         --- states of parts found
  KI_int_nitems            *nparts         --- number of parts found
  KI_cod_error             *ifail          --- failure indicator

Specific errors:
  KI_key_not_found          part with key not found in memory

Description:
  IDKYPA returns a list of the parts with the given key which are attached to
  the world. A list of the states of the parts is also returned.

  All parts in the world are scanned until a stored, modified or unloaded
  part with the given key is found. New and anonymous parts do not have
  keys and cannot be found with this function.

  There may actually be more than one part with the same key. They are either
  all modified or one is stored/unloaded. In this situation the tags of all the
  parts will be returned.

  If no part with the given key is attached to the world, KI_key_not_found will
  be returned in 'ifail'.