INFO: Additional Information About GetTypeByName

• Microsoft Win32 Software Development Kit (SDK), versions 3.51, 4.0

SUMMARY

GetTypeByName takes a service name in string format and returns a global unique identifier (GUID) for it. GetTypeByName is documented in the Win32 SDK. This article is an addendum to the documentation.

MORE INFORMATION

The purpose of GetTypeByName is to retrieve a GUID of a service. It does this first by examining the registry, looking for a local service. If the key does not exist, the function conducts a search of well-known TCP and UDP service types. If the service GUID is still unknown, a final comparison is made against a hard-coded list. See Srvguid.h for a list of most of the known GUIDs.

All comparisons made by GetTypeByName are case-sensitive.

GetTypeByName is exported from Wsock32.dll. To use it for anything other than registry information retrieval, call WSAStartup first. If WSAStartup is not called prior to calling GetTypeByName, the function fails, and GetLastError returns ERROR_SERVICE_DOES_NOT_EXIST, not WSANOTINITIALIZED.

REFERENCES

"Win32 Software Development Kit Programmer's Reference," version 3.51.

Keywords          : kbnetwork kbAPI kbNTOS351 kbSDKPlatform kbWinOS95 kbGrpNet 
Version           : 
Platform          : 
Issue type        : kbinfo 

Last Reviewed: March 5, 1999