index.md - mozsearch

Enable keyboard shortcuts

(mozilla-projects-nss-reference-fc-digestfinal)=

# FC_DigestFinal

## [Name](#name)

:::{container}

FC_DigestFinal - finish a multi-part digest operation.

:::

## [Syntax](#syntax)

:::{container}

```{code}

CK_RV FC_DigestFinal(

  CK_SESSION_HANDLE hSession,

  CK_BYTE_PTR pDigest,

  CK_ULONG_PTR pulDigestLen

);

```

:::

## [Parameters](#parameters)

:::{container}

`hSession`

: [in] session handle.

`pDigest`

: [out] pointer to the buffer which will receive the digest or NULL.

`pulDigestLen`

: [in, out] pointer to location containing the maximum buffer size.

:::

## [Description](#description)

:::{container}

`FC_DigestFinal` finishes a multi-part digest operation by returning the complete digest and

clearing the operation context. If `pDigest` is NULL the length of the digest is returned and

`FC_DigestFinal` may be called again with `pDigest` set to retrieve the digest.

A user may call `FC_DigestFinal` without logging into the token (to assume the NSS User role).

:::

## [Return value](#return_value)

## [Examples](#examples)

## [See also](#see_also)

:::{container}

- {ref}`mozilla_projects_nss_reference_fc_digestinit`,

  [NSC_DigestFinal](/en-US/NSC_DigestFinal)

:::