INFO: Additional Information About GetTypeByName (138038)



The information in this article applies to:

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

This article was previously published under Q138038

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.

Modification Type:MajorLast Reviewed:3/7/1999
Keywords:kbAPI kbinfo kbnetwork KB138038