---
name: "Fapi_SetBranchCB"
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_SetBranchCB"
---

# Fapi\_SetBranchCB(3)

Fapi\_SetBranchCB

## NAME

Fapi\_SetBranchCB - Fapi\_SetBranchCB

## SYNOPSIS

### Typedefs

typedef TSS2\_RC(\* **Fapi\_CB\_Branch**) (char const \*objectPath, char const \*description, char const \*\*branchNames, size\_t numBranches, size\_t \*selectedBranch, void \*userData)\

### Functions

TSS2\_RC **Fapi\_SetBranchCB** (**FAPI\_CONTEXT** \*context, Fapi\_CB\_Branch callback, void \*userData)\

## Detailed Description

FAPI functions to invoke SetBranchCB.

## Function Documentation

### TSS2\_RC Fapi\_SetBranchCB (FAPI\_CONTEXT \* context, Fapi\_CB\_Branch callback, void \* userData)

This function registers a callback that will be invoked whenever the FAPI has to decide which branch of a Policy-OR policy to use to authorize a particular FAPI operation.

**Parameters**

*context* The **FAPI\_CONTEXT** \
 *callback* The callback function for branch selection \
 *userData* A pointer that is provided to all callback invocations

**Return values**

*TSS2\_RC\_SUCCESS* if the function call was a success. \
 *TSS2\_FAPI\_RC\_BAD\_REFERENCE* if the context is NULL. \
 *TSS2\_FAPI\_RC\_BAD\_CONTEXT* if context corruption is detected. \
 *TSS2\_FAPI\_RC\_MEMORY* if the FAPI cannot allocate enough memory for internal operations or return parameters. \
 *TSS2\_FAPI\_RC\_BAD\_SEQUENCE* if the synchronous or Async functions are called while the context has another asynchronous operation outstanding, or the Finish function is called while the context does not have an appropriate asynchronous operation outstanding. \
 *TSS2\_FAPI\_RC\_IO\_ERROR* if the data cannot be saved.

## Author

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