CFHTTPMessage.pas 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408
  1. {
  2. File: CFNetwork/CFHTTPMessage.h
  3. Contains: CoreFoundation Network socket streams header
  4. Version: CFNetwork-71.2~1
  5. Copyright: © 2001-2003 by Apple Computer, Inc., all rights reserved
  6. Bugs?: For bug reports, consult the following page on
  7. the World Wide Web:
  8. http://www.freepascal.org/bugs.html
  9. }
  10. { Pascal Translation: Peter N Lewis, <[email protected]>, 2004 }
  11. {
  12. Modified for use with Free Pascal
  13. Version 200
  14. Please report any bugs to <[email protected]>
  15. }
  16. {$mode macpas}
  17. {$packenum 1}
  18. {$macro on}
  19. {$inline on}
  20. {$CALLING MWPASCAL}
  21. unit CFHTTPMessage;
  22. interface
  23. {$setc UNIVERSAL_INTERFACES_VERSION := $0342}
  24. {$setc GAP_INTERFACES_VERSION := $0200}
  25. {$ifc not defined USE_CFSTR_CONSTANT_MACROS}
  26. {$setc USE_CFSTR_CONSTANT_MACROS := TRUE}
  27. {$endc}
  28. {$ifc defined CPUPOWERPC and defined CPUI386}
  29. {$error Conflicting initial definitions for CPUPOWERPC and CPUI386}
  30. {$endc}
  31. {$ifc defined FPC_BIG_ENDIAN and defined FPC_LITTLE_ENDIAN}
  32. {$error Conflicting initial definitions for FPC_BIG_ENDIAN and FPC_LITTLE_ENDIAN}
  33. {$endc}
  34. {$ifc not defined __ppc__ and defined CPUPOWERPC}
  35. {$setc __ppc__ := 1}
  36. {$elsec}
  37. {$setc __ppc__ := 0}
  38. {$endc}
  39. {$ifc not defined __i386__ and defined CPUI386}
  40. {$setc __i386__ := 1}
  41. {$elsec}
  42. {$setc __i386__ := 0}
  43. {$endc}
  44. {$ifc defined __ppc__ and __ppc__ and defined __i386__ and __i386__}
  45. {$error Conflicting definitions for __ppc__ and __i386__}
  46. {$endc}
  47. {$ifc defined __ppc__ and __ppc__}
  48. {$setc TARGET_CPU_PPC := TRUE}
  49. {$setc TARGET_CPU_X86 := FALSE}
  50. {$elifc defined __i386__ and __i386__}
  51. {$setc TARGET_CPU_PPC := FALSE}
  52. {$setc TARGET_CPU_X86 := TRUE}
  53. {$elsec}
  54. {$error Neither __ppc__ nor __i386__ is defined.}
  55. {$endc}
  56. {$setc TARGET_CPU_PPC_64 := FALSE}
  57. {$ifc defined FPC_BIG_ENDIAN}
  58. {$setc TARGET_RT_BIG_ENDIAN := TRUE}
  59. {$setc TARGET_RT_LITTLE_ENDIAN := FALSE}
  60. {$elifc defined FPC_LITTLE_ENDIAN}
  61. {$setc TARGET_RT_BIG_ENDIAN := FALSE}
  62. {$setc TARGET_RT_LITTLE_ENDIAN := TRUE}
  63. {$elsec}
  64. {$error Neither FPC_BIG_ENDIAN nor FPC_LITTLE_ENDIAN are defined.}
  65. {$endc}
  66. {$setc ACCESSOR_CALLS_ARE_FUNCTIONS := TRUE}
  67. {$setc CALL_NOT_IN_CARBON := FALSE}
  68. {$setc OLDROUTINENAMES := FALSE}
  69. {$setc OPAQUE_TOOLBOX_STRUCTS := TRUE}
  70. {$setc OPAQUE_UPP_TYPES := TRUE}
  71. {$setc OTCARBONAPPLICATION := TRUE}
  72. {$setc OTKERNEL := FALSE}
  73. {$setc PM_USE_SESSION_APIS := TRUE}
  74. {$setc TARGET_API_MAC_CARBON := TRUE}
  75. {$setc TARGET_API_MAC_OS8 := FALSE}
  76. {$setc TARGET_API_MAC_OSX := TRUE}
  77. {$setc TARGET_CARBON := TRUE}
  78. {$setc TARGET_CPU_68K := FALSE}
  79. {$setc TARGET_CPU_MIPS := FALSE}
  80. {$setc TARGET_CPU_SPARC := FALSE}
  81. {$setc TARGET_OS_MAC := TRUE}
  82. {$setc TARGET_OS_UNIX := FALSE}
  83. {$setc TARGET_OS_WIN32 := FALSE}
  84. {$setc TARGET_RT_MAC_68881 := FALSE}
  85. {$setc TARGET_RT_MAC_CFM := FALSE}
  86. {$setc TARGET_RT_MAC_MACHO := TRUE}
  87. {$setc TYPED_FUNCTION_POINTERS := TRUE}
  88. {$setc TYPE_BOOL := FALSE}
  89. {$setc TYPE_EXTENDED := FALSE}
  90. {$setc TYPE_LONGLONG := TRUE}
  91. uses MacTypes,CFString,CFURL,CFBase,CFData,CFDictionary;
  92. {$ALIGN MAC68K}
  93. {
  94. * kCFHTTPVersion1_0
  95. *
  96. * Availability:
  97. * Mac OS X: in version 10.1 and later in CoreServices.framework
  98. * CarbonLib: not available
  99. * Non-Carbon CFM: not available
  100. }
  101. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  102. var kCFHTTPVersion1_0: CFStringRef; external name '_kCFHTTPVersion1_0'; (* attribute const *)
  103. {
  104. * kCFHTTPVersion1_1
  105. *
  106. * Availability:
  107. * Mac OS X: in version 10.1 and later in CoreServices.framework
  108. * CarbonLib: not available
  109. * Non-Carbon CFM: not available
  110. }
  111. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  112. var kCFHTTPVersion1_1: CFStringRef; external name '_kCFHTTPVersion1_1'; (* attribute const *)
  113. {
  114. * kCFHTTPAuthenticationSchemeBasic
  115. *
  116. * Availability:
  117. * Mac OS X: in version 10.2 and later in CoreServices.framework
  118. * CarbonLib: not available
  119. * Non-Carbon CFM: not available
  120. }
  121. // AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER
  122. var kCFHTTPAuthenticationSchemeBasic: CFStringRef; external name '_kCFHTTPAuthenticationSchemeBasic'; (* attribute const *)
  123. {
  124. * kCFHTTPAuthenticationSchemeDigest
  125. *
  126. * Availability:
  127. * Mac OS X: in version 10.2 and later in CoreServices.framework
  128. * CarbonLib: not available
  129. * Non-Carbon CFM: not available
  130. }
  131. // AVAILABLE_MAC_OS_X_VERSION_10_2_AND_LATER
  132. var kCFHTTPAuthenticationSchemeDigest: CFStringRef; external name '_kCFHTTPAuthenticationSchemeDigest'; (* attribute const *)
  133. { Currently unsupported }
  134. type
  135. CFHTTPMessageRef = ^SInt32; { an opaque 32-bit type }
  136. {
  137. * CFHTTPMessageGetTypeID()
  138. *
  139. * Availability:
  140. * Mac OS X: in version 10.1 and later in CoreServices.framework
  141. * CarbonLib: not available
  142. * Non-Carbon CFM: not available
  143. }
  144. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  145. function CFHTTPMessageGetTypeID: CFTypeID; external name '_CFHTTPMessageGetTypeID';
  146. {
  147. * CFHTTPMessageCreateRequest()
  148. *
  149. * Availability:
  150. * Mac OS X: in version 10.1 and later in CoreServices.framework
  151. * CarbonLib: not available
  152. * Non-Carbon CFM: not available
  153. }
  154. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  155. function CFHTTPMessageCreateRequest( allocator: CFAllocatorRef; requestMethod: CFStringRef; url: CFURLRef; httpVersion: CFStringRef ): CFHTTPMessageRef; external name '_CFHTTPMessageCreateRequest';
  156. { Pass NULL to use the standard description for the given status code, as found in RFC 2616}
  157. {
  158. * CFHTTPMessageCreateResponse()
  159. *
  160. * Availability:
  161. * Mac OS X: in version 10.1 and later in CoreServices.framework
  162. * CarbonLib: not available
  163. * Non-Carbon CFM: not available
  164. }
  165. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  166. function CFHTTPMessageCreateResponse( allocator: CFAllocatorRef; statusCode: SInt32; statusDescription: CFStringRef; httpVersion: CFStringRef ): CFHTTPMessageRef; external name '_CFHTTPMessageCreateResponse';
  167. { Creates an empty request or response, which you can then append bytes to via CFHTTPMessageAppendBytes(). The HTTP header information will be parsed out as the bytes are appended.}
  168. {
  169. * CFHTTPMessageCreateEmpty()
  170. *
  171. * Availability:
  172. * Mac OS X: in version 10.1 and later in CoreServices.framework
  173. * CarbonLib: not available
  174. * Non-Carbon CFM: not available
  175. }
  176. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  177. function CFHTTPMessageCreateEmpty( allocator: CFAllocatorRef; isRequest: Boolean ): CFHTTPMessageRef; external name '_CFHTTPMessageCreateEmpty';
  178. {
  179. * CFHTTPMessageCreateCopy()
  180. *
  181. * Availability:
  182. * Mac OS X: in version 10.1 and later in CoreServices.framework
  183. * CarbonLib: not available
  184. * Non-Carbon CFM: not available
  185. }
  186. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  187. function CFHTTPMessageCreateCopy( allocator: CFAllocatorRef; message: CFHTTPMessageRef ): CFHTTPMessageRef; external name '_CFHTTPMessageCreateCopy';
  188. { Whether the message is a response or a request}
  189. {
  190. * CFHTTPMessageIsRequest()
  191. *
  192. * Availability:
  193. * Mac OS X: in version 10.1 and later in CoreServices.framework
  194. * CarbonLib: not available
  195. * Non-Carbon CFM: not available
  196. }
  197. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  198. function CFHTTPMessageIsRequest( message: CFHTTPMessageRef ): Boolean; external name '_CFHTTPMessageIsRequest';
  199. {
  200. * CFHTTPMessageCopyVersion()
  201. *
  202. * Availability:
  203. * Mac OS X: in version 10.1 and later in CoreServices.framework
  204. * CarbonLib: not available
  205. * Non-Carbon CFM: not available
  206. }
  207. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  208. function CFHTTPMessageCopyVersion( message: CFHTTPMessageRef ): CFStringRef; external name '_CFHTTPMessageCopyVersion';
  209. {
  210. * CFHTTPMessageCopyBody()
  211. *
  212. * Availability:
  213. * Mac OS X: in version 10.1 and later in CoreServices.framework
  214. * CarbonLib: not available
  215. * Non-Carbon CFM: not available
  216. }
  217. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  218. function CFHTTPMessageCopyBody( message: CFHTTPMessageRef ): CFDataRef; external name '_CFHTTPMessageCopyBody';
  219. {
  220. * CFHTTPMessageSetBody()
  221. *
  222. * Availability:
  223. * Mac OS X: in version 10.1 and later in CoreServices.framework
  224. * CarbonLib: not available
  225. * Non-Carbon CFM: not available
  226. }
  227. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  228. procedure CFHTTPMessageSetBody( message: CFHTTPMessageRef; bodyData: CFDataRef ); external name '_CFHTTPMessageSetBody';
  229. {
  230. * CFHTTPMessageCopyHeaderFieldValue()
  231. *
  232. * Availability:
  233. * Mac OS X: in version 10.1 and later in CoreServices.framework
  234. * CarbonLib: not available
  235. * Non-Carbon CFM: not available
  236. }
  237. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  238. function CFHTTPMessageCopyHeaderFieldValue( message: CFHTTPMessageRef; headerField: CFStringRef ): CFStringRef; external name '_CFHTTPMessageCopyHeaderFieldValue';
  239. {
  240. * CFHTTPMessageCopyAllHeaderFields()
  241. *
  242. * Availability:
  243. * Mac OS X: in version 10.1 and later in CoreServices.framework
  244. * CarbonLib: not available
  245. * Non-Carbon CFM: not available
  246. }
  247. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  248. function CFHTTPMessageCopyAllHeaderFields( message: CFHTTPMessageRef ): CFDictionaryRef; external name '_CFHTTPMessageCopyAllHeaderFields';
  249. {
  250. * CFHTTPMessageSetHeaderFieldValue()
  251. *
  252. * Availability:
  253. * Mac OS X: in version 10.1 and later in CoreServices.framework
  254. * CarbonLib: not available
  255. * Non-Carbon CFM: not available
  256. }
  257. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  258. procedure CFHTTPMessageSetHeaderFieldValue( message: CFHTTPMessageRef; headerField: CFStringRef; value: CFStringRef ); external name '_CFHTTPMessageSetHeaderFieldValue';
  259. { The following function appends the given bytes to the message given (parsing out any control information if appropriate). Returns FALSE if a parsing error occurs while processing the new data.}
  260. {
  261. * CFHTTPMessageAppendBytes()
  262. *
  263. * Availability:
  264. * Mac OS X: in version 10.1 and later in CoreServices.framework
  265. * CarbonLib: not available
  266. * Non-Carbon CFM: not available
  267. }
  268. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  269. function CFHTTPMessageAppendBytes( message: CFHTTPMessageRef; newBytes: UnivPtr; numBytes: CFIndex ): Boolean; external name '_CFHTTPMessageAppendBytes';
  270. { Whether further header data is expected by the message}
  271. {
  272. * CFHTTPMessageIsHeaderComplete()
  273. *
  274. * Availability:
  275. * Mac OS X: in version 10.1 and later in CoreServices.framework
  276. * CarbonLib: not available
  277. * Non-Carbon CFM: not available
  278. }
  279. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  280. function CFHTTPMessageIsHeaderComplete( message: CFHTTPMessageRef ): Boolean; external name '_CFHTTPMessageIsHeaderComplete';
  281. {
  282. * CFHTTPMessageCopySerializedMessage()
  283. *
  284. * Availability:
  285. * Mac OS X: in version 10.1 and later in CoreServices.framework
  286. * CarbonLib: not available
  287. * Non-Carbon CFM: not available
  288. }
  289. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  290. function CFHTTPMessageCopySerializedMessage( request: CFHTTPMessageRef ): CFDataRef; external name '_CFHTTPMessageCopySerializedMessage';
  291. {*******************}
  292. { Request functions }
  293. {*******************}
  294. {
  295. * CFHTTPMessageCopyRequestURL()
  296. *
  297. * Availability:
  298. * Mac OS X: in version 10.1 and later in CoreServices.framework
  299. * CarbonLib: not available
  300. * Non-Carbon CFM: not available
  301. }
  302. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  303. function CFHTTPMessageCopyRequestURL( request: CFHTTPMessageRef ): CFURLRef; external name '_CFHTTPMessageCopyRequestURL';
  304. {
  305. * CFHTTPMessageCopyRequestMethod()
  306. *
  307. * Availability:
  308. * Mac OS X: in version 10.1 and later in CoreServices.framework
  309. * CarbonLib: not available
  310. * Non-Carbon CFM: not available
  311. }
  312. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  313. function CFHTTPMessageCopyRequestMethod( request: CFHTTPMessageRef ): CFStringRef; external name '_CFHTTPMessageCopyRequestMethod';
  314. { Tries to modify request to contain the authentication information
  315. requested by authenticationFailureResponse (which presumably is a
  316. 401 or 407 response). Returns TRUE if successful; FALSE otherwise
  317. (leaving request unmodified). If authenticationScheme is NULL, the
  318. strongest supported scheme listed in failedResponse will be used. }
  319. {
  320. * CFHTTPMessageAddAuthentication()
  321. *
  322. * Availability:
  323. * Mac OS X: in version 10.1 and later in CoreServices.framework
  324. * CarbonLib: not available
  325. * Non-Carbon CFM: not available
  326. }
  327. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  328. function CFHTTPMessageAddAuthentication( request: CFHTTPMessageRef; authenticationFailureResponse: CFHTTPMessageRef; username: CFStringRef; password: CFStringRef; authenticationScheme: CFStringRef; forProxy: Boolean ): Boolean; external name '_CFHTTPMessageAddAuthentication';
  329. {********************}
  330. { Response functions }
  331. {********************}
  332. {
  333. * CFHTTPMessageGetResponseStatusCode()
  334. *
  335. * Availability:
  336. * Mac OS X: in version 10.1 and later in CoreServices.framework
  337. * CarbonLib: not available
  338. * Non-Carbon CFM: not available
  339. }
  340. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  341. function CFHTTPMessageGetResponseStatusCode( response: CFHTTPMessageRef ): UInt32; external name '_CFHTTPMessageGetResponseStatusCode';
  342. {
  343. * CFHTTPMessageCopyResponseStatusLine()
  344. *
  345. * Availability:
  346. * Mac OS X: in version 10.1 and later in CoreServices.framework
  347. * CarbonLib: not available
  348. * Non-Carbon CFM: not available
  349. }
  350. // AVAILABLE_MAC_OS_X_VERSION_10_1_AND_LATER
  351. function CFHTTPMessageCopyResponseStatusLine( response: CFHTTPMessageRef ): CFStringRef; external name '_CFHTTPMessageCopyResponseStatusLine';
  352. end.