Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Inside Macintosh: Networking With Open Transport / Part 2 - Open Transport Reference

Chapter 29 - TCP/IP Services Reference / Functions

Getting Information About an Internet Host /

OTInetSysInfo
Returns details about a host's processor and operating system.

C INTERFACE
OSStatus OTInetSysInfo (InetSvcRef ref,
                                         char *name,
                                         InetSysInfo *sysi
C++ INTERFACE
OSStatus TInternetServices::SysInfo (char *name,
                                         InetSysInfo *sysinfo);
PARAMETERS

ref
The internet services reference you obtained when you opened the TCP/IP service provider.
name
The name of the host about which you want information. This can be a host name (including the local host), a partially qualified domain name, or a fully qualified domain name.
sysinfo
A pointer to an InetSysInfo structure. You must allocate this structure. The function fills it in with the processor type and operating-system version of the host.
function result
A result code. See Appendix B for more information.

DISCUSSION
The information returned by this function is maintained by the domain name server. If you call this function asynchronously, the TCP/IP service provider calls your notifier function with the T_DNRSYSINFOCOMPLETE completion event code when the function completes. The cookie parameter to the notifier function contains the sysinfo parameter. If you had more than one simultaneous outstanding call to the OTInetSysInfo function, you can use this information to determine which call has completed execution.

SPECIAL CONSIDERATIONS
If you call this function asynchronously, do not modify the InetSysInfo structure until the function completes. The information is held in the domain name server's database and it is often incomplete and inaccurate.