bulk: return the server hint from bulk execute.

Author: Christian Hergert

doc/mongoc_bulk_operation_execute.page

@@ -15,7 +15,7 @@
 
   <section id="synopsis">
     <title>Synopsis</title>
-    <synopsis><code mime="text/x-csrc"><![CDATA[bool
+    <synopsis><code mime="text/x-csrc"><![CDATA[uint32_t
 mongoc_bulk_operation_execute (mongoc_bulk_operation_t *bulk,
                                bson_t                  *reply,
                                bson_error_t            *error);
@@ -43,7 +43,7 @@ mongoc_bulk_operation_execute (mongoc_bulk_operation_t *bulk,
 
   <section id="return">
     <title>Returns</title>
-    <p><code>true</code> on success, otherwise <code>false</code> and <code>error</code> is set.</p>
+    <p>A non-zero <code>hint</code> of the peer node on success, otherwise <code>0</code> and <code>error</code> is set.</p>
   </section>
 
 

src/mongoc/mongoc-bulk-operation.c

@@ -270,7 +270,7 @@ mongoc_bulk_operation_update_one (mongoc_bulk_operation_t *bulk,
 }
 
 
-bool
+uint32_t
 mongoc_bulk_operation_execute (mongoc_bulk_operation_t *bulk,  /* IN */
                                bson_t                  *reply, /* OUT */
                                bson_error_t            *error) /* OUT */
@@ -349,7 +349,7 @@ mongoc_bulk_operation_execute (mongoc_bulk_operation_t *bulk,  /* IN */
 cleanup:
    ret = _mongoc_write_result_complete (&bulk->result, reply, error);
 
-   RETURN (ret);
+   RETURN (ret ? hint : 0);
 }
 
 void

src/mongoc/mongoc-bulk-operation.h

@@ -31,7 +31,7 @@ typedef struct _mongoc_bulk_operation_t mongoc_bulk_operation_t;
 
 
 void mongoc_bulk_operation_destroy     (mongoc_bulk_operation_t       *bulk);
-bool mongoc_bulk_operation_execute     (mongoc_bulk_operation_t       *bulk,
+uint32_t mongoc_bulk_operation_execute (mongoc_bulk_operation_t       *bulk,
                                         bson_t                        *reply,
                                         bson_error_t                  *error);
 void mongoc_bulk_operation_delete      (mongoc_bulk_operation_t       *bulk,