/*
 * Portions of this file Copyright 1999-2005 University of Chicago
 * Portions of this file Copyright 1999-2005 The University of Southern California.
 *
 * This file or a portion of this file is licensed under the
 * terms of the Globus Toolkit Public License, found at
 * http://www.globus.org/toolkit/download/license.html.
 * If you redistribute this file, with or without
 * modifications, you must include this notice in the file.
 */


/*
 * This file is automatically generated by the Globus WSDLtoC converter
 */

#ifndef _WST_REQUESTEDTOKENREFERENCETYPE_H_
#define _WST_REQUESTEDTOKENREFERENCETYPE_H_

#include "globus_common.h"
#include "globus_xsd_type_info.h"

#ifndef GLOBUS_DONT_DOCUMENT_INTERNAL
EXTERN_C_BEGIN
#endif /* GLOBUS_DONT_DOCUMENT_INTERNAL */

/**
 * The wst_RequestedTokenReferenceType complex type, which represents the
 * {http://schemas.xmlsoap.org/ws/2004/04/trust}RequestedTokenReferenceType element.
 * @ingroup wst_RequestedTokenReferenceType
 */
typedef struct wst_RequestedTokenReferenceType_s wst_RequestedTokenReferenceType;
/**
 * The wst_RequestedTokenReferenceType_o complex type, which represents an optional instance
 * of a
 * {http://schemas.xmlsoap.org/ws/2004/04/trust}RequestedTokenReferenceType element.
 * @ingroup wst_RequestedTokenReferenceType
 */
typedef wst_RequestedTokenReferenceType * wst_RequestedTokenReferenceType_o;

/**
 * Namespace of the wst_RequestedTokenReferenceType complex type
 * @ingroup wst_RequestedTokenReferenceType
 */
#define WST_REQUESTEDTOKENREFERENCETYPE_NS "http://schemas.xmlsoap.org/ws/2004/04/trust"
/**
 * Local part of the QName of the wst_RequestedTokenReferenceType complex type
 * @ingroup wst_RequestedTokenReferenceType
 */
#define WST_REQUESTEDTOKENREFERENCETYPE_LOCAL "RequestedTokenReferenceType"

/**
 * QName of the wst_RequestedTokenReferenceType complex type
 * @ingroup wst_RequestedTokenReferenceType
 */
extern xsd_QName wst_RequestedTokenReferenceType_qname;
/**
 * Type information for serializing and deserializing wst_RequestedTokenReferenceType elements
 * @ingroup wst_RequestedTokenReferenceType
 */
extern struct globus_xsd_type_info_s wst_RequestedTokenReferenceType_info;
/**
 * Type information for serializing and deserializing arrays of wst_RequestedTokenReferenceType
 * elements
 * @ingroup wst_RequestedTokenReferenceType
 */
extern struct globus_xsd_type_info_s wst_RequestedTokenReferenceType_array_info;
/**
 * Type information for serializing and deserializing the contents of
 * wst_RequestedTokenReferenceType without surrounding elements
 * @ingroup wst_RequestedTokenReferenceType
 */
extern struct globus_xsd_type_info_s wst_RequestedTokenReferenceType_contents_info;


#include "wsse_SecurityTokenReferenceType.h"
#include "wst_RequestedTokenReferenceType_array.h"

/**
 * @defgroup wst_RequestedTokenReferenceType Complex type: wst_RequestedTokenReferenceType
 * @ingroup types
 */

/**
 * C structure for the wst_RequestedTokenReferenceType complex type
 * @ingroup wst_RequestedTokenReferenceType
 */
struct wst_RequestedTokenReferenceType_s
{
    /** wsse_SecurityTokenReferenceType subelement */
    wsse_SecurityTokenReferenceType SecurityTokenReference;

};

/**
 * Initialize a wst_RequestedTokenReferenceType
 * @ingroup wst_RequestedTokenReferenceType
 *
 * Allocates a new wst_RequestedTokenReferenceType and initializes its contents. When the
 * structure is no longer needed, it should be freed by calling 
 * wst_RequestedTokenReferenceType_destroy(). 
 *
 * @param inst
 *     Pointer to set to a newly allocated instance.
 */
globus_result_t
wst_RequestedTokenReferenceType_init(
    wst_RequestedTokenReferenceType ** inst);

/**
 * Destroy a wst_RequestedTokenReferenceType
 * @ingroup wst_RequestedTokenReferenceType
 *
 * Frees a wst_RequestedTokenReferenceType. All subelements and attributes will be destroyed
 * (and freed if they are optional).
 *
 * @param inst
 *     Pointer to the instance to destroy.
 */
void
wst_RequestedTokenReferenceType_destroy(
    wst_RequestedTokenReferenceType * inst);

/**
 * Copy a wst_RequestedTokenReferenceType
 * @ingroup wst_RequestedTokenReferenceType
 *
 * Perform a deep copy of a wst_RequestedTokenReferenceType.
 * The @a dest structure will be allocated, and then a copy of the contents
 * of @a src and its subelements and attributes will be made to @a dest.
 * 
 * @param dest
 *     The wst_RequestedTokenReferenceType structure to be initialized with a copy of the
 *     contents of the @a src structure.
 * @param src
 *     Source wst_RequestedTokenReferenceType to be copied.
 */
globus_result_t
wst_RequestedTokenReferenceType_copy(
    wst_RequestedTokenReferenceType ** dest,
    const wst_RequestedTokenReferenceType * src);

/**
 * Initialize the contents of a wst_RequestedTokenReferenceType
 * @ingroup wst_RequestedTokenReferenceType
 *
 * Initialize the contents of a wst_RequestedTokenReferenceType. This should be used
 * when the structure is allocated on the stack or by a some allocator besides
 * wst_RequestedTokenReferenceType_init(). The contents may be freed
 * by calling wst_RequestedTokenReferenceType_destroy_contents().
 *
 * @param instance
 *     Pointer to an allocated but uninitialized wst_RequestedTokenReferenceType.
 */
globus_result_t
wst_RequestedTokenReferenceType_init_contents(
    wst_RequestedTokenReferenceType * instance);

/**
 * Destroy the contents of a wst_RequestedTokenReferenceType
 * @ingroup wst_RequestedTokenReferenceType
 *
 * Destroy the subelements and attributes of the given wst_RequestedTokenReferenceType. 
 *
 * @param inst
 *     Pointer to a wst_RequestedTokenReferenceType instance to destroy.
 */
void
wst_RequestedTokenReferenceType_destroy_contents(
    wst_RequestedTokenReferenceType * inst);

/**
 * Copy the contents of a wst_RequestedTokenReferenceType
 * @ingroup wst_RequestedTokenReferenceType
 *
 * Perform a deep copy of the contents of a wst_RequestedTokenReferenceType.
 * The @a dest strcuture must be allocated before making this call.
 * A copy of the subelements and attributes of @ src will be made to
 * @a dest.
 * 
 * @param dest
 *     Structure to be initialized with copies of the contents of @a src.
 * @param src
 *     Source wst_RequestedTokenReferenceType to be copied.
 */
globus_result_t
wst_RequestedTokenReferenceType_copy_contents(
    wst_RequestedTokenReferenceType * dest,
    const wst_RequestedTokenReferenceType * src);

/**
 * Serialize a wst_RequestedTokenReferenceType
 * @ingroup wst_RequestedTokenReferenceType_array
 * Serialize a wst_RequestedTokenReferenceType structure.
 *
 * @param element_name
 *     The name of the element which will contain the wst_RequestedTokenReferenceType.
 * @param val
 *     The wst_RequestedTokenReferenceType to serialize.
 * @param message_handle
 *     The handle to serialize the element on.
 * @param options
 *     Serialization options.
 */
globus_result_t
wst_RequestedTokenReferenceType_serialize(
    xsd_QName *                         element_name,
    wst_RequestedTokenReferenceType * val,
    globus_soap_message_handle_t        message_handle,
    globus_xsd_element_options_t        options);

/**
 * Serialize the contents of a wst_RequestedTokenReferenceType
 * @ingroup wst_RequestedTokenReferenceType_array
 * Serialize a wst_RequestedTokenReferenceType structure without an enclosing element.
 *
 * @param element_name
 *     Ignored parameter.
 * @param val
 *     The wst_RequestedTokenReferenceType to serialize.
 * @param message_handle
 *     The handle to serialize the contents on.
 * @param options
 *     Serialization options.
 */
globus_result_t
wst_RequestedTokenReferenceType_serialize_contents(
    xsd_QName *                         element_name,
    wst_RequestedTokenReferenceType * val,
    globus_soap_message_handle_t        message_handle,
    globus_xsd_element_options_t        options);

/**
 * Deserialize a wst_RequestedTokenReferenceType
 * @ingroup wst_RequestedTokenReferenceType
 * Deserialize an element containing a wst_RequestedTokenReferenceType element.
 *
 * @param element_name
 *     The name of the element which should enclose the wst_RequestedTokenReferenceType.
 * @param val
 *     Pointer to the wst_RequestedTokenReferenceType which will be initialized with the
 *     value of the element.
 * @param message_handle
 *     The handle to deserialize the element from.
 * @param options
 *     Deserialization options.
 */
globus_result_t
wst_RequestedTokenReferenceType_deserialize(
    xsd_QName *                         element_name,
    wst_RequestedTokenReferenceType * val,
    globus_soap_message_handle_t        message_handle,
    globus_xsd_element_options_t        options);

/**
 * Deserialize a wst_RequestedTokenReferenceType
 * @ingroup wst_RequestedTokenReferenceType
 * Deserialize a wst_RequestedTokenReferenceType whose enclosing element has already been
 * deserialized.
 *
 * @param element_name
 *     Ignored.
 * @param val
 *     Pointer to the wst_RequestedTokenReferenceType which will be initialized with the
 *     value of the current element.
 * @param message_handle
 *     The handle to deserialize the element from.
 * @param options
 *     Deserialization options.
 */
globus_result_t
wst_RequestedTokenReferenceType_deserialize_contents(
    xsd_QName *                         element_name,
    wst_RequestedTokenReferenceType * val,
    globus_soap_message_handle_t        message_handle,
    globus_xsd_element_options_t        options);

/**
 * Deserialize an optional wst_RequestedTokenReferenceType
 * @ingroup wst_RequestedTokenReferenceType
 * Deserialize the next element if it contains a wst_RequestedTokenReferenceType.
 *
 * @param element_name
 *     The name of the element which should enclose the wst_RequestedTokenReferenceType.
 * @param instance
 *     Pointer to the <code>wst_RequestedTokenReferenceType *</code> which will be allocated
 *     and initialized with the value of the element if it is present.
 * @param message_handle
 *     The handle to deserialize the element from.
 * @param options
 *     Deserialization options.
 */
globus_result_t
wst_RequestedTokenReferenceType_deserialize_pointer(
    xsd_QName *                         element_name,
    wst_RequestedTokenReferenceType ** instance,
    globus_soap_message_handle_t        message_handle,
    globus_xsd_element_options_t        options);

#ifndef GLOBUS_DONT_DOCUMENT_INTERNAL

globus_result_t
wst_RequestedTokenReferenceType_init_wrapper(
    void **                             object);
    
void
wst_RequestedTokenReferenceType_destroy_wrapper(
    void *                              object);
    
globus_result_t
wst_RequestedTokenReferenceType_copy_wrapper(
    void **                             dest_obj,
    void *                              src_obj);

globus_result_t
wst_RequestedTokenReferenceType_init_contents_wrapper(
    void *                              object);
    
void
wst_RequestedTokenReferenceType_destroy_contents_wrapper(
    void *                              object);
    
globus_result_t
wst_RequestedTokenReferenceType_copy_contents_wrapper(
    void *                              dest_obj,
    void *                              src_obj);

globus_result_t
wst_RequestedTokenReferenceType_serialize_wrapper(
    xsd_QName *                         element_qname,
    void *                              instance,
    globus_soap_message_handle_t        message_handle,
    globus_xsd_element_options_t        options);
    
globus_result_t
wst_RequestedTokenReferenceType_serialize_contents_wrapper(
    xsd_QName *                         element_qname,
    void *                              instance,
    globus_soap_message_handle_t        message_handle,
    globus_xsd_element_options_t        options);
    
globus_result_t
wst_RequestedTokenReferenceType_deserialize_contents_wrapper(
    xsd_QName *                         element_qname,
    void **                             instance,
    globus_soap_message_handle_t        message_handle,
    globus_xsd_element_options_t        options);

globus_result_t
wst_RequestedTokenReferenceType_deserialize_pointer_wrapper(
    xsd_QName *                         element_qname,
    void **                             ip,
    globus_soap_message_handle_t        message_handle,
    globus_xsd_element_options_t        options);
#endif /* GLOBUS_DONT_DOCUMENT_INTERNAL */

#ifndef GLOBUS_DONT_DOCUMENT_INTERNAL
EXTERN_C_END
#endif /* GLOBUS_DONT_DOCUMENT_INTERNAL */

#endif
