DhcpUndoRequestParams 函数 (dhcpcsdk.h)

DhcpUndoRequestParams 函数删除以前通过 DhcpRequestParams 函数调用发出的持久请求。

语法

DWORD DhcpUndoRequestParams(
  [in] DWORD  Flags,
  [in] LPVOID Reserved,
  [in] LPWSTR AdapterName,
  [in] LPWSTR RequestIdStr
);

参数

[in] Flags

保留。 必须为零。

[in] Reserved

保留供将来使用。 必须设置为 NULL

[in] AdapterName

不再需要其信息的适配器的 GUID。 必须低于 256 个字符。

注意 不再使用此参数。
 

[in] RequestIdStr

最初用于发出持久请求的应用程序标识符 (ID) 。 此字符串必须与获取相应持久请求的 DhcpRequestParams 函数调用中使用的 RequestIdStr 参数匹配。 请注意,这必须与之前使用的应用程序标识符 (ID) 匹配,并且必须是不含特殊字符的可打印字符串, (逗号、反斜杠、冒号或其他非法字符不得) 使用。

返回值

成功完成后返回ERROR_SUCCESS。 否则, 将返回 Windows 错误代码。

注解

永久性请求通常由与应用程序关联的设置或安装程序进程发出。 适当时,安装或安装程序过程可能会进行 DhcpUndoRequestParams 函数调用,以取消其关联的持久请求。

要求

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

另请参阅

DHCP 函数

DhcpCApiInitialize

DhcpRequestParams