Compartilhar via


Função DhcpUndoRequestParams (dhcpcsdk.h)

A função DhcpUndoRequestParams remove solicitações persistentes feitas anteriormente com uma chamada de função DhcpRequestParams .

Sintaxe

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

Parâmetros

[in] Flags

Reservado. Deve ser zero.

[in] Reserved

Reservado para uso futuro. Deve ser definido como NULL.

[in] AdapterName

GUID do adaptador para o qual as informações não são mais necessárias. Deve ter menos de 256 caracteres.

Nota Esse parâmetro não é mais usado.
 

[in] RequestIdStr

ID (identificador de aplicativo) usado originalmente para fazer uma solicitação persistente. Essa cadeia de caracteres deve corresponder ao parâmetro RequestIdStr usado na chamada de função DhcpRequestParams que obteve a solicitação persistente correspondente. Observe que isso deve corresponder à ID (identificador de aplicativo) anterior usada e deve ser uma cadeia de caracteres imprimível sem caracteres especiais (vírgulas, barras invertidas, dois-pontos ou outros caracteres ilegais não podem ser usados).

Retornar valor

Retorna ERROR_SUCCESS após a conclusão bem-sucedida. Caso contrário, retorna um código de erro do Windows.

Comentários

Normalmente, as solicitações persistentes são feitas pelo processo de instalação ou instalador associado ao aplicativo. Quando apropriado, o processo de instalação ou instalador provavelmente faria com que a função DhcpUndoRequestParams cancelasse sua solicitação persistente associada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho dhcpcsdk.h
Biblioteca Dhcpcsvc.lib
DLL Dhcpcsvc.dll

Confira também

Funções DHCP

DhcpCApiInitialize

DhcpRequestParams