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,
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.3RhEnableSwitchoverRequestNotification
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
72 | High Availability Software for the Intel® NetStructureTM ZT 4901 Technical Product Specification |
