High Availability Software for the Intel® NetStructureTM ZT 4901 Technical Product Specification 71
Redundant Host API
DomainCallback pointer to the callback function that tracks state of the domain
SlotCallback - pointer to the optional callback function that tr acks state of separate slots
during software connection and disconnection.
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
Other, implementation-defined HSI_STATUS values
returned if other errors occurred during execution of this function
Synopsis:
This function establishes a callback that is called when the software connection state of one of the
domains changes. The callback function is called with the domain number and the new state 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.
Four additional parameters, “RequestingHost”, “DestinationHost”, “Timeout” and “Persist,” are
passed to the domain state notification callback when software disconnection is requested for the
domain and the domain state becomes DISCONNECTING. They are passed unchanged from the
parameter list for the RhPrepareForSwitchover function.
Values of these parameters are not meaningful when the new domain state is different from
DISCONNECTING.
The parameter SlotStateCallback, if specified as non-NULL, should be an address of the slot state
change notification callback. This callback is called when the state of a specific slot in the domain
changes and allows the caller to track software connection and disconnection on a per-slot basis.
This function can be used to get notification about the progress of a pending s oftware connect ion or
disconnection request during a cooperative switchover.
The function can be called on a host that does not own the specified domain.
6.2.6.2 RhEnableSwitchoverNotification
Prototype:
HSI_STATUS
RhEnableSwitchoverNotification(
IN RH_HANDLE Handle,
IN RH_SWITCHOVER_CALLBACK Callback,
IN void *pContext,
IN BOOLEAN Systemwide);
Arguments:
Handle – the handle of the current session