wp_switch_roles_and_user( int $new_site_id, int $old_site_id )

Switches the initialized roles and current user capabilities to another site.

Parameters

$new_site_id

(int) (Required) New site ID.

$old_site_id

(int) (Required) Old site ID.

Source

File: wp-includes/ms-blogs.php 

function wp_switch_roles_and_user( $new_site_id, $old_site_id ) {
	if ( $new_site_id == $old_site_id ) {
		return;
	}

	if ( ! did_action( 'init' ) ) {
		return;
	}

	wp_roles()->for_site( $new_site_id );
	wp_get_current_user()->for_site( $new_site_id );
}

Expand Source Code View on GitHub

Related

Uses

Uses
Uses Description
wp-includes/pluggable.php: wp_get_current_user()

Retrieve the current user object.
wp-includes/capabilities.php: wp_roles()

Retrieves the global WP_Roles instance and instantiates it if necessary.
wp-includes/plugin.php: did_action()

Retrieve the number of times an action is fired.
wp-includes/class-wp-roles.php: WP_Roles::for_site()

Sets the site to operate on. Defaults to the current site.

Changelog

Changelog
Version Description
WP-4.9.0 Introduced.