pips_set_default_provider()

Updated: October 26, 2022

Set the default publish/subscribe provider

Synopsis:

#include <pips/pips.h>
pips_provider_t* pips_set_default_provider(const char *name)

Arguments:

name
The name of a provider that is registered in the current process and is to be made the default

Library:

pips-client

Description:

This function sets the default provider in the current process to the provider with the given name.

Prerequisites

The named provider must be registered in the current process.

Postrequisites

If this function succeeds, subsequent calls to pips_get_provider() with a NULL argument will return a handle to the provider associated with the given name.

Returns:

On success, a handle to the new default provider. On error, NULL (errno is set).

Errors:

  • EINVAL: The provider name is invalid.
  • ENOENT: The named provider isn't registered in the current process.