Intel ZT 4901 manual Domain is written as a null-terminated string, SlotPathLength, Character

Redundant Host API

HSI_STATUS

RhGetDomainSlotPath (

IN RH_HANDLE Handle,

IN uint32 Host,

IN uint32 Domain,

OUT uint16 *pRootBus,

	OUT char *pOutSlotPath,
	IN uint32 SlotPathLength,
	OUT ULONG *pActualSize );
Arguments:
Handle –	the handle of the current session
Host -	the target host number
Domain –	the domain number
pRootBus –	pointer to the variable where the infrastructure stores the root bus
	number of the PCI tree of this domain. This value is 0 for the first or
	single PCI tree. For additional PCI trees, this value is implementation-
	dependent, but is guaranteed to be non-zero.
pOutSlotPath	pointer to the buffer where the slot path of the root bridge of the specified
	domain is written as a null-terminated string
SlotPathLength	the size of the buffer; if this size is too small for the output, this function
	fails. The size of the maximum possible output is 513 characters (for the
	longest slot path in the system with 256 buses plus the null termination
	character).
pActualSize -	this variable receives the actual size of the returned slot path; in the case
	of HSI_STATUS_INSUFFICIENT_BUFFER, this is the minimum
	required size of the buffer.
Return Value:

HSI_STATUS_SUCCESS

returned in the case of success

HSI_STATUS_INVALID_PARAMETER

invalid session handle or the domain number is invalid

HSI_STATUS_INSUFFICIENT_BUFFER

returned if SlotPathLength is too small

Other, implementation-defined HSI_STATUS values

returned if other errors occurred during execution of this function

Synopsis:

This function returns the slot path of the domain parent bridge for the specified domain with respect to the target host.

This function is guaranteed to return successfully only if the target host owns the specified domain. If the target host does not own the specified domain, the function fails, unless the infrastructure knows in advance what slot path the domain will have when owned by the target host. This slot path must not be affected by any switchovers that may take place in the RH system before the target host actually acquires the specified domain.

48 High Availability Software for the Intel® NetStructureTM ZT 4901 Technical Product Specification