Return a snapshot of the current state of the Connection. 
- Resource Management:
 - This function allocates resources that must later be freed by calling DOFConnectionState_Destroy.
 
- Note
 - The state of the Connection is dynamic and may change at any moment, due to a number of reasons. It is usually best to track the state of a Connection through a state listener.
 
- Parameters
 - 
  
    | self | The Connection. This must not be NULL. | 
  
   
- Returns
 - The snapshot of the current state of the Connection.
 
- See Also
 - DOFConnection_AddStateListener