Filter
Top Products
72 High Availability Software for the Intel
®
NetStructure
TM
ZT 4901 Technical Product Specification
Redundant Host API
Callback – pointer to the callback function
Context – an opaque context pointer; passed unchanged to the callback function.
Systemwide – a Boolean flag; if set to TRUE, notification happens for each switchover
even if the current host is neither the source nor the destination of the
switchover; if set to FALSE, the host is notified only of those
switchovers in which it participates.
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 establishes the callback that is called when any domain is switched over from one
host to another. The callback function is called with the new owner host number and the domain
number as parameters. Another parameter, pContext, is passed unchanged from the function that
establishes the callback to the callback itself and can be used to pass some context information.
An application may subscribe for notifications about all domain switchovers in the system by
setting parameter Systemwide to TRUE.
6.2.6.3 RhEnableSwitchoverRequestNotification
Prototype:
HSI_STATUS
RhEnableSwitchoverNotification(
IN RH_HANDLE Handle,
IN RH_SWITCHOVER_REQUEST_CALLBACK Callback,
IN void *pContext );
Arguments:
Handle – the handle of the current session
Callback – pointer to the callback function
pContext – an opaque context pointer; passed unchanged to the callback function.
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