Obtiene un documento de clave por un nombre alternativo

# MongoDB\Driver\ClientEncryption::getKeyByAltName

(mongodb >=1.15.0)

MongoDB\Driver\ClientEncryption::getKeyByAltName — Obtiene un documento de clave por un nombre alternativo

### Descripción

final public function MongoDB\Driver\ClientEncryption::getKeyByAltName(string `$keyAltName`): ?object

Busca un único documento de clave en la colección de almacén de claves con el nombre alternativo `keyAltName` proporcionado.

### Parámetros

`keyAltName`
  Nombre alternativo para el documento de clave.

### Valores devueltos

Devuelve el documento de clave, o `null` si no se encontró ningún documento.

### Errores/Excepciones

- Lanza una excepción MongoDB\Driver\InvalidArgumentException en caso de error durante el análisis de un argumento.
- Lanza una excepción MongoDB\Driver\ConnectionException si la conexión al servidor falla por una razón distinta a un problema de identificación
- Lanza una excepción MongoDB\Driver\AuthenticationException si se requiere una identificación pero falla
- Lanza MongoDB\Driver\Exception\RuntimeException en caso de otros errores.

### Ver también

- MongoDB\Driver\ClientEncryption::addKeyAltName() - Añade un nombre alternativo a un documento de clave
- MongoDB\Driver\ClientEncryption::removeKeyAltName() - Elimina un nombre alternativo de un documento de clave

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open