GetTypeByName
Important The GetTypeByName
function is a Microsoft-specific extension to the Windows Sockets 1.1
specification. This function is obsolete. For the convenience of Windows
Sockets 1.1 developers, the reference material is below.
In Windows
Sockets 2, this functionality is realized with the functions detailed in Protocol-Independent
Name Resolution.
The GetTypeByName
function obtains a service type GUID for a network service specified by
name.
INT GetTypeByName(
|
LPTSTR lpServiceName, |
// points to the
name of the network service |
|
PGUID lpServiceType |
// points to a
variable to receive network service type |
|
); |
|
Parameters
lpServiceName
Points to a
zero-terminated string that uniquely represents the name of the service. For
example, MY SNA SERVER .
lpServiceType
Points to a
variable to receive a globally unique identifier (GUID) that specifies
the type of the network service. The header file SVCGUID.H includes definitions
of several GUID service types and macros for working with them.
Return Values
If the
function succeeds, the return value is zero.
If the
function fails, the return value is SOCKET_ERROR( - 1). To get extended error information, call GetLastError. GetLastError may
return the following extended error value:
|
Value |
Meaning |
|
ERROR_SERVICE_DOES_NOT_EXIST |
The
specified service type is unknown. |
See Also