GetNameByTypeA 函数（nspapi.h）

GetNameByType 函数检索指定服务类型的网络服务的名称。

注释GetNameByType 函数是特定于 Windows 套接字 1.1 规范的Microsoft扩展。此函数已过时。为方便 Windows 套接字 1.1 开发人员，参考资料如下所示。

注意Protocol-Independent 名称解析中详述的函数在 Windows 套接字 2 中提供等效的功能。

语法

INT GetNameByTypeA(
  [in]  LPGUID lpServiceType,
  [out] LPSTR  lpServiceName,
  [in]  DWORD  dwNameLength
);

[in] lpServiceType

指向指定网络服务类型的全局唯一标识符（GUID）的指针。 Svcguid.h 头文件包括多个 GUID 服务类型的定义，以及用于处理它们的宏。

Winsock2.h 头文件不会自动包含 Svcguid. h 头文件。

[out] lpServiceName

指向缓冲区的指针，用于接收唯一表示网络服务名称的零终止字符串。

[in] dwNameLength

指向一个变量的指针，该变量在输入中指定由 lpServiceName指向的缓冲区的大小（以字节为单位）。在输出中，变量包含服务名称字符串的实际大小（以字节为单位）。

如果函数成功，则返回值不会SOCKET_ERROR（–1）。

如果函数失败，则返回值SOCKET_ERROR （–1）。若要获取扩展的错误信息，请调用 GetLastError。

注意

nspapi.h 标头将 GetNameByType 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求	价值
最低支持的客户端	Windows 2000 Professional [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
目标平台	窗户
标头	nspapi.h
库	Mswsock.lib
DLL	Mswsock.dll