mongoc_client_pool_append_metadata - Man Page

bool
mongoc_client_pool_append_metadata (mongoc_client_pool_t *pool,
                                    const char *name,
                                    const char *version,
                                    const char *platform)

This function is identical to mongoc_client_append_metadata() <> except for client pools.

See mongoc_client_append_metadata() <> and mongoc_handshake_data_append() <> for more details.

The updated handshake command applies to the given pool object for connections established after the append took place.

Also note that mongoc_client_append_metadata() <> cannot be called on a client retrieved from a client pool.

• pool: A mongoc_client_pool_t <>.
• name: The name of the wrapping driver. Must not be null or an empty string.
• version: The optional version of the wrapping driver.
• platform: The optional information about the current platform, for example configure options or compile flags.

No string argument may contain the substring " / ", which is used as the delimiter between metadata field values.

This function will log an error and return false when one of the following occurs:

• The resulting handshake document would exceed the size limit.

Otherwise, true if the given fields are set successfully.

This function is safe to call from multiple threads.

See also:

mongoc_client_append_metadata() <>

mongoc_handshake_data_append() <>

MongoDB, Inc

2009-present, MongoDB, Inc.