---
name: "mongoc_client_encryption_remove_key_alt_name"
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_client_encryption_remove_key_alt_name"
---

# mongoc\_client\_encryption\_remove\_key\_alt\_name(3)

## SYNOPSIS

```
bool
mongoc_client_encryption_remove_key_alt_name (
   mongoc_client_encryption_t *client_encryption,
   const bson_value_t *keyid,
   const char *keyaltname,
   bson_t *key_doc,
   bson_error_t *error);
```

Remove **keyaltname** from the set of keyAltNames in the key document with UUID **keyid**.

Also removes the **keyAltNames** field from the key document if it would otherwise be empty.

## PARAMETERS

- •

  **client\_encryption**: A *mongoc\_client\_encryption\_t*.

- •

  **keyid**: The UUID (BSON binary subtype 0x04) of the key to remove the key alternate name from.

- •

  **keyaltname**: The key alternate name to remove.

- •

  **key\_doc**: Optional. An uninitialized *bson\_t* set to the value of the key document before removal of the key alternate name, or an empty document the key does not exist. Must be freed by *bson\_value\_destroy()*.

- •

  **error**: Optional. *bson\_error\_t*.

## RETURNS

Returns **true** if successful. Returns **false** and sets **error** otherwise.

**SEE ALSO:**

```
mongoc_client_encryption_t
```

## AUTHOR

MongoDB, Inc

## COPYRIGHT

2009-present, MongoDB, Inc.