---
name: "Fapi_GetPollHandles"
section: "3"
platform: "linux"
package: "tpm2-tss"
version: "4.2.0-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Fapi_GetPollHandles"
---

# Fapi\_GetPollHandles(3)

Fapi\_GetPollHandles

## NAME

Fapi\_GetPollHandles - Fapi\_GetPollHandles

## SYNOPSIS

### Functions

TSS2\_RC **Fapi\_GetPollHandles** (**FAPI\_CONTEXT** \*context, FAPI\_POLL\_HANDLE \*\*handles, size\_t \*num\_handles)\

## Detailed Description

FAPI function to retrieve the poll handles currently used by the corresponding **FAPI\_CONTEXT**.

## Function Documentation

### TSS2\_RC Fapi\_GetPollHandles (FAPI\_CONTEXT \* context, FAPI\_POLL\_HANDLE \*\* handles, size\_t \* num\_handles)

Retrieve handles for polling

Returns an array of handles that can be polled on to get notified when data from the TPM or from a disk operation is available.

The corresponding code should look similar to follows: do { r = Fapi\_GetPollHandles(fc, &ph, &nph); if (r == TSS2\_RC\_SUCCESS) { poll(ph, nph, -1); Fapi\_Free(ph); } r = Fapi\_\*\_Finish(fc, ...); } while (r == TSS2\_FAPI\_RC\_TRY\_AGAIN);

**Parameters**

*context* The **FAPI\_CONTEXT** \
 *handles* An array of poll handle entries \
 *num\_handles* The size of the array in handles

**Return values**

*TSS2\_RC\_SUCCESS* if the function call was a success. \
 *TSS2\_FAPI\_RC\_BAD\_REFERENCE* if context or data is NULL. \
 *TSS2\_FAPI\_RC\_BAD\_CONTEXT* if context corruption is detected. \
 *TSS2\_FAPI\_RC\_BAD\_SEQUENCE* if the context has no asynchronous operation pending. \
 *TSS2\_FAPI\_RC\_NO\_HANDLE* if there are no handles to poll on \
 *TSS2\_FAPI\_RC\_MEMORY* if the FAPI cannot allocate enough memory for internal operations or return parameters.

## Author

Generated automatically by Doxygen for tpm2-tss from the source code.