MdeModulePkg:DxeHttpLib: Update to DxeHttpLib API

[mirror_edk2.git] / MdeModulePkg / Include / Library / HttpLib.h

diff --git a/MdeModulePkg/Include/Library/HttpLib.h b/MdeModulePkg/Include/Library/HttpLib.h
index af9ab5f012c6b71e8353875bb10856ffee320bbc..853982025c25aeb215f1a1b38dc1a2372ad5a8cf 100644 (file)
--- a/MdeModulePkg/Include/Library/HttpLib.h
+++ b/MdeModulePkg/Include/Library/HttpLib.h
@@ -417,12 +417,20 @@ HttpFreeHeaderFields (
   );\r
 \r
 /**\r
-  Generate HTTP request string.\r
+  Generate HTTP request message.\r
 \r
-  @param[in]   Message            Pointer to storage containing HTTP message data.\r
+  This function will allocate memory for the whole HTTP message and generate a\r
+  well formatted HTTP Request message in it, include the Request-Line, header\r
+  fields and also the message body. It is the caller's responsibility to free\r
+  the buffer returned in *RequestMsg.\r
+\r
+  @param[in]   Message            Pointer to the EFI_HTTP_MESSAGE structure which\r
+                                  contains the required information to generate\r
+                                  the HTTP request message.\r
   @param[in]   Url                The URL of a remote host.\r
-  @param[out]  RequestString      Pointer to the created HTTP request string.\r
+  @param[out]  RequestMsg         Pointer to the created HTTP request message.\r
                                   NULL if any error occured.\r
+  @param[out]  RequestMsgSize     Size of the RequestMsg (in bytes).\r
 \r
   @return EFI_SUCCESS             If HTTP request string was created successfully\r
   @retval EFI_OUT_OF_RESOURCES    Failed to allocate resources.\r
@@ -431,10 +439,11 @@ HttpFreeHeaderFields (
 **/\r
 EFI_STATUS\r
 EFIAPI\r
-HttpGenRequestString (\r
+HttpGenRequestMessage (\r
   IN     CONST EFI_HTTP_MESSAGE        *Message,\r
   IN     CONST CHAR8                   *Url,\r
-     OUT CHAR8                         **RequestString\r
+     OUT CHAR8                         **RequestMsg,\r
+     OUT UINTN                         *RequestMsgSize\r
   );\r
 \r
 /**\r