Filter
Top Products
68 High Availability Software for the Intel
®
NetStructure
TM
ZT 4901 Technical Product Specification
Redundant Host API
HSI_STATUS
RhPerformSwitchover(
IN RH_HANDLE Handle,
IN uint32 DestinationHost,
IN uint32 *pDomains,
IN uint32 DomainCount,
IN BOOLEAN Reset,
IN BOOLEAN Hostile );
Arguments:
Handle – the handle of the current session
DestinationHost the number of the host that should own the domains after the switchover;
value RH_NO_DESTINATION_HOST means “no host should own the
specified domains”
pDomains – the array of domain numbers that should be taken over. Passing NULL
as this parameter requests that all existing domains should be switched
over to the destination host.
DomainCount - the number of items in the array pDomains.
Reset – if TRUE, the PCI buses of domains are reset after the switchover
Hostile - if TRUE, the switchover is performed in a hostile way (the owning host
is not given any opportunity before the switchover to be notified and to
prevent it).
Return Value:
HSI_STATUS_SUCCESS returned in the case of success
HSI_STATUS_INVALID_PARAMETER
invalid session handle or any of the specified domains do not exist, or
wrong parameters are specified (for example, DomainCount=0 and
Domains != NULL).
HSI_STATUS_REQUEST_DENIED
the switchover request for the specified domains by the current host has
been denied
HSI_STATUS_NOT_SUPPORTED
returned if this function with the specified set of parameters is not
supported by the infrastructure
Other, implementation-defined HSI_STATUS values
returned if other errors occurred during execution of this function
Synopsis:
This function performs the switchover. It is called on a host that currently owns the specified
domains or on some other host to request switchover of the specified domains to the destination
host. If the parameter Reset is TRUE, the corresponding domains are initially reset after the
switchover by the new owning host.
6.2.5.7 RhSetHwDestinationHost
Prototype: