1998-06-25 05:50:45 +00:00
|
|
|
/* -*- Mode: C; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
|
|
|
/*
|
1999-11-06 03:40:37 +00:00
|
|
|
* The contents of this file are subject to the Netscape Public
|
|
|
|
|
* License Version 1.1 (the "License"); you may not use this file
|
|
|
|
|
* except in compliance with the License. You may obtain a copy of
|
|
|
|
|
* the License at http://www.mozilla.org/NPL/
|
1998-06-25 05:50:45 +00:00
|
|
|
*
|
1999-11-06 03:40:37 +00:00
|
|
|
* Software distributed under the License is distributed on an "AS
|
|
|
|
|
* IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
|
|
|
|
|
* implied. See the License for the specific language governing
|
|
|
|
|
* rights and limitations under the License.
|
1998-06-25 05:50:45 +00:00
|
|
|
*
|
1999-11-06 03:40:37 +00:00
|
|
|
* The Original Code is mozilla.org code.
|
|
|
|
|
*
|
|
|
|
|
* The Initial Developer of the Original Code is Netscape
|
1998-06-25 05:50:45 +00:00
|
|
|
* Communications Corporation. Portions created by Netscape are
|
1999-11-06 03:40:37 +00:00
|
|
|
* Copyright (C) 1998 Netscape Communications Corporation. All
|
|
|
|
|
* Rights Reserved.
|
|
|
|
|
*
|
|
|
|
|
* Contributor(s):
|
1998-06-25 05:50:45 +00:00
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
This file defines the way of getting a URL that you can put into generated
|
|
|
|
|
HTML. If the user accesses that URL, then the callback function you
|
|
|
|
|
provided will get called with the data you provided.
|
|
|
|
|
|
|
|
|
|
Currently, this is all implemented in lib/libnet/mkcburl.c.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
/* make sure we only include this once */
|
|
|
|
|
#ifndef _NET_CBURL_H_
|
|
|
|
|
#define _NET_CBURL_H_
|
|
|
|
|
|
|
|
|
|
XP_BEGIN_PROTOS
|
|
|
|
|
|
|
|
|
|
typedef void (*NET_CallbackURLFunc)(void* closure, const char* url);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* Creates a callback URL. Returns a string which is a valid URL that you
|
|
|
|
|
can emit into an HTML stream. (Returns NULL on out-of-memory error.)
|
|
|
|
|
The returned string must be freed using XP_FREE(). If the returned URL
|
|
|
|
|
is ever processed, then the given function will be called with the given
|
|
|
|
|
closure. The actual URL string is also passed, so that the function
|
|
|
|
|
can process any form data and the like. */
|
|
|
|
|
|
|
|
|
|
char*
|
|
|
|
|
NET_CallbackURLCreate(NET_CallbackURLFunc func, void* closure);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* Informs the callback system that the given function and closure are no
|
|
|
|
|
longer valid. This frees all storage associated with the above call,
|
|
|
|
|
and must be called at some point or a memory leak will result. */
|
|
|
|
|
|
|
|
|
|
int
|
|
|
|
|
NET_CallbackURLFree(NET_CallbackURLFunc func, void* closure);
|
|
|
|
|
|
|
|
|
|
XP_END_PROTOS
|
|
|
|
|
|
|
|
|
|
#endif /* _NET_CBURL_H_ */
|
