getTypeByNameW 函数 (nspapi.h)

GetTypeByName 函数检索由 name 指定的网络服务的服务类型 GUID。

注意GetTypeByName 函数是 Windows Sockets 1.1 规范的特定于 Microsoft 的扩展。 此函数已过时。 为方便 Windows 套接字 1.1 开发人员，我们提供了此参考资料。 独立于协议的名称解析中详述的函数在 Windows 套接字 2 中提供了等效的功能。

 

语法

INT GetTypeByNameW(
  [in]      LPWSTR lpServiceName,
  [in, out] LPGUID lpServiceType
);

参数

[in] lpServiceName

指向以零结尾的字符串的指针，该字符串唯一表示服务的名称。 例如，“MY SNA SERVER”。

[in, out] lpServiceType

指向变量的指针，用于接收指定网络服务类型的 GUID) (全局唯一标识符。 Svcguid.h 头文件包含多个 GUID 服务类型和用于使用这些类型的宏的定义。

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

返回值

如果函数成功，则返回值为 0。

如果函数失败，则返回值SOCKET_ERROR ( – 1) 。 若要获取扩展错误信息，请调用 GetLastError，这将返回以下扩展错误值。

值	含义
ERROR_SERVICE_DOES_NOT_EXIST	指定的服务类型未知。

注解

注意

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

要求

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

另请参阅

GetNameByType

Winsock 函数

Winsock 参考