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.
See Also