Inside Macintosh: Open Transport /

Chapter 8 - TCP/IP Services / 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 *sysinfo);

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.

DESCRIPTION

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 a pointer to the InetSysInfo structure you specified in 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 write to the InetSysInfo structure until the function completes.

COMPLETION EVENT CODES

T_DNRSYSINFOCOMPLETE

0x10000003

The OTInetSysInfo function has completed.

SEE ALSO

The InetSysInfo structure is described in "Internet System Information Structure" on page 8-27.