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,
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.7RhSetHwDestinationHost
Prototype:
68 | High Availability Software for the Intel® NetStructureTM ZT 4901 Technical Product Specification |
