3.1.5.8.1 GSS_Query_meta_data

  • Article

The GSS_Query_meta_data function is used to retrieve a security mechanism’s metadata. The major_status codes are specified in [RFC2743].<6>

GSS_Query_meta_data

Inputs:

  • input_context_handle CONTEXT HANDLE,

  • targ_name INTERNAL NAME, optional

  • deleg_req_flag BOOLEAN,

  • mutual_req_flag BOOLEAN,

  • replay_det_req_flag BOOLEAN,

  • sequence_req_flag BOOLEAN,

  • conf_req_flag BOOLEAN,

  • integ_req_flag BOOLEAN

Outputs:

  • metadata OCTET STRING,

  • output_context_handle CONTEXT HANDLE

Return major_status codes:

  • GSS_S_COMPLETE indicates that the context referenced by the input_context_handle argument is valid, and that the output metadata value represents the security mechanism's provided metadata. A security mechanism can return empty metadata.

  • GSS_S_NO_CONTEXT indicates that no valid context was recognized for the input context_handle that was provided. Return values other than major_status and minor_status are undefined.

  • GSS_S_NO_CRED indicates that no metadata could be returned about the referenced credentials either because the input cred_handle was invalid or the caller lacks authorization to access the referenced credentials.

  • GSS_S_UNAVAILABLE indicates that the authentication security service does not support this operation.

  • GSS_S_FAILURE indicates that the requested operation failed for reasons unspecified at the GSS-API level. Return values other than major_status and minor_status are undefined.