pips_get_registered_providers()

Updated: April 19, 2023

Get the list of registered providers

Synopsis:

#include <pips/pips.h>
int pips_get_registered_providers(const char *const *provider_names[])

Arguments:

provider_names
A pointer to memory for storing the address of an array that will contain the names of all registered providers. The library retains ownership of this array, so the client must not delete it.

Library:

pips-client

Description:

This function queries the provider factory for the list of providers that have been registered with it, and writes the provider names into an array of immutable strings.

Returns:

On success, the number of providers registered with the factory. On error, -1 (errno is set).

Errors:

  • EINVAL: The pointer to space for storing the array address is NULL.