getNameByTypeA 函数 (nspapi.h)
GetNameByType 函数检索指定服务类型的网络服务的名称。
注意GetNameByType 函数是 Windows 套接字 1.1 规范的特定于 Microsoft 的扩展。 此函数已过时。 为方便 Windows 套接字 1.1 开发人员,参考材料如下所示。
注意独立于协议的名称解析中详述的函数在 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 [仅限桌面应用] |
目标平台 | Windows |
标头 | nspapi.h |
Library | Mswsock.lib |
DLL | Mswsock.dll |