Intel ZT 4901 Network Router User Manual


 
High Availability Software for the Intel
®
NetStructure
TM
ZT 4901 Technical Product Specification 47
Redundant Host API
Other, implementation-defined HSI_STATUS values
returned if other errors occurred during execution of this function
Synopsis:
This function retrieves the list of numbers of known domains that comprise the RH system. Each
domain number is an arbitrary uint32 value.
Before the call, the caller should allocate a buffer that can accommodate a sufficient number of
uint32 values, and pass its address in the pDomainNumbersArray parameter. The parameter
ArraySize should be set equal to the size of the buffer in uint32 items. The domain count returned
from “RhGetDomainCount” can be used as the value of this parameter. On return, the function
populates the buffer with the array of domain numbers for all domains in the system, and places the
actual number of returned domain numbers into the output parameter *pActualSize. If the specified
ArraySize is too small, the function returns status HSI_STATUS_INSUFFICIENT_BUFFER, and
doesn’t populate the buffer, but still sets the parameter *pActualSize to the required size of the
buffer.
6.2.3.3 RhGetDomainOwnership
Prototype:
HSI_STATUS
RhGetDomainOwnership(
IN RH_HANDLE Handle,
IN uint32 Domain,
OUT uint32 *pOwningHost );
Arguments:
Handle – the handle of the current session
Domain – the domain number
pOwningHost pointer to the variable that stores the number of the host (if any) that
owns this domain; value RH_NO_DESTINATION_HOST means “not
owned by any host”
Return Value:
HSI_STATUS_SUCCESS
returned in the case of success
HSI_STATUS_INVALID_PARAMETER
invalid session handle
Other, implementation-defined HSI_STATUS values
returned if other errors occurred during execution of this function
Synopsis:
This function returns the current owning host for the specified domain.
6.2.3.4 RhGetDomainSlotPath
Prototype: