通过

GetTypeByNameA 函数 （nspapi.h）

  • 项目

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

NoteGetTypeByName 函数是特定于 Windows Sockets 1.1 规范的Microsoft扩展。 此函数已过时。 为方便 Windows 套接字 1.1 开发人员，此参考资料已包含在内。 Protocol-Independent 名称解析 中详述的函数在 Windows 套接字 2 中提供等效的功能。
 

语法

INT GetTypeByNameA(
  [in]      LPSTR  lpServiceName,
  [in, out] LPGUID lpServiceType
);

参数

[in] lpServiceName

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

[in, out] lpServiceType

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

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

返回值

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

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

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

言论

注意

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

要求

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

另请参阅

GetNameByType

Winsock 函数

Winsock 参考