High Availability Software for the Intel® NetStructureTM ZT 4901 Technical Product Specification 37
Redundant Host API 6

6.1 Intel-Specific APIs

6.1.1 RhSetHostName

Prototype:
RH_API_DEF HSI_STATUS
RhSetHostName(
IN RH_HANDLE Handle,
IN uint32 Host,
IN char HostName[ ])
Arguments:
Handle - The handle of the current session
Host - The host number
HostName - The character buffer where the host name is stored as a 0-terminated
character string
Return Value:
HSI_STATUS_SUCCESS - returned in the case of success
RH_INVALID_HANDLE - invalid session handle
HSI_STATUS_NOT_SUPPOR TED - returned if this function is not supported by the infrastructure
Other HSI_STATUS values - if errors occurred during execution of this function such as
nonexistent host
Synopsis:
This function sets the symbolic name of the specified host; this should be some kind of network
name (for example, NETBIOS name or TCP/IP host name) that can be used to establish a network
connection to that host.
6.1.1.1 RhGetHwDestinationHostAndReset
Prototype:
HSI_STATUS
RhGetHwDestinationHostAndReset(
IN RH_HANDLE Handle,
IN uint32 SourceHost,
IN uint32 Domain,
OUT uint32 *pDestinationHost,