70 High Availability Software for the Intel® NetStructureTM ZT 4901 Technical Product Specification
Redundant Host API
6.2.5.8 RhGetHwDestinationHost
Prototype:
HSI_STATUS
RhGetHwDestinationHost(
IN RH_HANDLE Handle,
IN uint32 SourceHost,
IN uint32 Domain,
OUT uint32 *pDestinationHost );
Arguments:
Handle – the handle of the current session
SourceHost - the number of the source host
Domain – the domain number
pDestinationHost pointer to the variable receives the number of the host that should own
the specified domain if the source host fails and hardware-initiated
switchover takes place for it
Return Value:
HSI_STATUS_SUCCESS returned in the case of success
HSI_STATUS_INVALID_PARAMETER
invalid session handle or the specified domain does not exist
HSI_STATUS_NOT_SUPPORTED
returned if this function 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 gets the destination host that owns the specified domain if a hardware-initiated
switchover takes place due to the failure of the source host.
6.2.6 Notification, Reporting and Alarms6.2.6.1 RhEnableDomainStateNotification
Prototype:
HSI_STATUS
RhEnableDomainStateNotification(
IN RH_HANDLE Handle,
IN RH_DOMAIN_STATE_CALLBACK DomainCallback,
IN RH_SLOT_STATE_CALLBACK SlotCallback OPTIONAL,
IN void *pContext );
Arguments:
Handle – the handle of the current session