GetNameByType

Important The GetNameByType 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 GetNameByType function obtains the name of a network service. The network service is specified by its service type.

INT GetNameByType(

LPGUID lpServiceType,	// points to network service type GUID
LPTSTR lpServiceName,	// points to buffer to receive name of network service
DWORD dwNameLength	// points to variable that specifies buffer size
);

Parameters
lpServiceType

Points to 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.

lpServiceName

Points to a buffer to receive a zero-terminated string that uniquely represents the name of the network service.

dwNameLength

Points to a variable that, on input, specifies the size of the buffer pointed to by lpServiceName. On output, the variable contains the actual size of the service name string.

Return Values
If the function succeeds, the return value is not SOCKET_ERROR (

1).

If the function fails, the return value is SOCKET_ERROR (

1). To get extended error information, call GetLastError.