CURL.CreateHeaderOutputFile
---------------------------

Creates output file for writing header text.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [CURL](component_CURL.md) | [2.6](newinversion26.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "CURL.CreateHeaderOutputFile"; curl; Path ) 

**MBS**( **"CURL.CreateHeaderOutputFile";** /\* Creates output file for writing header text. \*/  
**$curl**; /\* The CURL session handle. \*/   
**$Path**) /\* Native file path.e.g. C:\\Documents\\Test.Txt \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| curl | The CURL session handle. | $curl |
| Path | Native file path. | C:\\Documents\\Test.Txt |

### Result

Returns "OK" on success or error message.

### Description

Creates output file for writing header text.  
Header messages are written to file if you use this functions and header text are always collected for calling [CURL.GetHeaders](CURLGetHeaders.md) after the transfer. This can be useful as you can have your FileMaker solution write a copy of headers in temporary file. If your client has problems, you can simply read headers from last transfer. If creation of the file fails, you get an error message back, but still your transfer will probably succeed.  
Do not call this method while a transfer is running.  
  
This function requires a native path. Use [Path.FileMakerPathToNativePath](PathFileMakerPathToNativePath.md) to convert a FileMaker path to a native path if required. If you like to have the user choose the path, you can use [FileDialog](component_FileDialog.md) functions.  
For Server be aware that server has limited permissions and may not be able to access all files on a computer.  
### Examples

Write copy of header texts to a file into temp folder on Mac:

 MBS ( "CURL.CreateHeaderOutputFile"; $curl ; "/tmp/LastHeaders.txt" )  
### See also

- [CURL.CloseHeaderFile](CURLCloseHeaderFile.md)
- [CURL.CreateDebugOutputFile](CURLCreateDebugOutputFile.md)
- [CURL.CreateOutputFile](CURLCreateOutputFile.md)
- [CURL.GetHeaders](CURLGetHeaders.md)
- [Path.FileMakerPathToNativePath](PathFileMakerPathToNativePath.md)

### Example Databases

- [CURL/FTP/CURL FTP Download File](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/CURL/FTP/CURL%20FTP%20Download%20File.shtml#2ScriptAnchor_)
- [CURL/FTP/CURL FTP Upload File](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/CURL/FTP/CURL%20FTP%20Upload%20File.shtml#2ScriptAnchor_)

### Blog Entries

- [MBS Filemaker Plugin, version 2.6pr4](https://www.mbsplugins.de/archive/2012-02-17/MBS_Filemaker_Plugin_version_2/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 18th August 2014 , last changed 3th January 2023

  
[CURL.CreateDebugOutputFile](CURLCreateDebugOutputFile.md) - [CURL.CreateOutputFile](CURLCreateOutputFile.md)

[HTML Version](CURLCreateHeaderOutputFile.shtml)