]>
Commit | Line | Data |
---|---|---|
11fdf7f2 TL |
1 | # Civetweb API Reference |
2 | ||
3 | ### `mg_send_digest_access_authentication_request( conn, realm );` | |
4 | ||
5 | ### Parameters | |
6 | ||
7 | | Parameter | Type | Description | | |
8 | | :--- | :--- | :--- | | |
9 | |**`conn`**|`struct mg_connection *`| A pointer to the connection to be used to send data | | |
10 | |**`realm`**|`const char *`| The requested authentication realm or NULL | | |
11 | ||
12 | ### Return Value | |
13 | ||
14 | | Type | Description | | |
15 | | :--- | :--- | | |
16 | |`int`| An integer indicating success or failure | | |
17 | ||
18 | ### Description | |
19 | ||
20 | This function can be used to send a HTTP Digest Authentication request to the client. | |
21 | Browsers will react with repeating the request with user authentication data. | |
22 | If they do not yet know the user authentication for the requested realm, they will show | |
23 | a dialog to query username and password. | |
24 | In case the authentication realm (also called domain) is NULL, the parameter | |
25 | `authentication_domain` from the server configuration is used. | |
26 | The function returns a negative number on errors. | |
27 | ||
28 | ### See Also | |
29 | ||
30 | * [`mg_check_digest_access_authentication();`](mg_check_digest_access_authentication.md) | |
31 | * [`mg_modify_passwords_file();`](mg_modify_passwords_file.md) | |
32 | * [`mg_send_http_error();`](mg_send_http_error.md) | |
33 | * [`mg_write();`](mg_write.md) | |
34 | * [`mg_printf();`](mg_print.md) | |
35 |