54 High Availability Software for the Intel® NetStructureTM ZT 4901 Technical Product Specification
Redundant Host API
HSI_STATUS_INSUFFICIENT_BUFFER
returned if the buffer OutHostName is too small to store the host name
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 returns the symbolic name for the specified host. This is some kind of a network
name (for example, NETBIOS name or TCP/IP host name) that can be used to establish a network
connection to that host. This allows the hosts to communicate with each other over the network.
6.2.3.12 RhSetHostAvailability
Prototype:
HSI_STATUS
RhSetHostAvailability(
IN RH_HANDLE Handle,
IN uint32 Host,
IN BOOLEAN Available);
Arguments:
Handle the handle of the current session
Host the host number
Available the new avail ability status of the host. Setting this argument to FALSE
means that the host is brought into “isolation mode” in which it cannot
own domains and cannot accept new domains via switchover. The host
should not have any owned domains when its availability status is set to
FALSE.
Return Value:
HSI_STATUS_SUCCESS returned in the case of success
HSI_STATUS_INVALID_PARAMETER
invalid session handle, or invalid target host number, or
Available=FALSE and the target host owns domains
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 changes the availability status of the target host for the RH infrastructure. Setting this
status to FALSE brings the host into “isolation mode” in which the host cannot own domains and
cannot participate in domain switchovers. For such a host, the function RhGetHostAvailability