---
name: "mongoc_cursor_set_server_id"
section: "3"
platform: "linux"
package: "libmongoc-doc"
version: "1.30.4-1+deb13u3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/mongoc_cursor_set_server_id"
---

# mongoc\_cursor\_set\_server\_id(3)

## SYNOPSIS

```
bool
mongoc_cursor_set_server_id (mongoc_cursor_t *cursor, uint32_t server_id)
```

## PARAMETERS

- •

  **cursor**: A *mongoc\_cursor\_t*.

- •

  **server\_id**: An opaque id identifying the server to use.

## DESCRIPTION

Specifies which server to use for the operation. This function has an effect only if called before the find operation is executed.

Use **mongoc\_cursor\_set\_server\_id** only for building a language driver that wraps the C Driver. When writing applications in C, leave the server id unset and allow the driver to choose a suitable server from the find operation's read preference.

## RETURNS

Returns true on success. If any arguments are invalid, returns false and logs an error.

## AUTHOR

MongoDB, Inc

## COPYRIGHT

2009-present, MongoDB, Inc.