Função DnsModifyRecordsInSet_UTF8 (windns.h)

  • Artigo

A função DnsModifyRecordsInSet adiciona, modifica ou remove um conjunto RR (Registro de Recurso) que pode ter sido registrado anteriormente com servidores DNS.

Como muitas funções DNS, o tipo de função DnsModifyRecordsInSet é implementado em várias formas para facilitar a codificação de caracteres diferente. Com base na codificação de caracteres envolvida, use uma das seguintes funções:

  • DnsModifyRecordsInSet_A (_A para codificação ANSI)
  • DnsModifyRecordsInSet_W (_W para codificação Unicode)
  • DnsModifyRecordsInSet_UTF8 (_UTF8 para codificação UTF 8)

Sintaxe

DNS_STATUS DnsModifyRecordsInSet_UTF8(
  [in, optional]      PDNS_RECORD pAddRecords,
  [in, optional]      PDNS_RECORD pDeleteRecords,
  [in]                DWORD       Options,
  [in, optional]      HANDLE      hCredentials,
  [in, out, optional] PVOID       pExtraList,
  [in, out, optional] PVOID       pReserved
);

Parâmetros

[in, optional] pAddRecords

Um ponteiro para a estrutura DNS_RECORD que contém as RRs a serem adicionadas ao conjunto de RR.

[in, optional] pDeleteRecords

Um ponteiro para a estrutura DNS_RECORD que contém as RRs a serem excluídas do conjunto de RR.

[in] Options

Um valor que contém um bitmap de Opções de Atualização DNS. As opções podem ser combinadas e todas as opções substituem DNS_UPDATE_SECURITY_USE_DEFAULT.

[in, optional] hCredentials

Um identificador para as credenciais de uma conta específica. Usado quando a atualização dinâmica segura é necessária. Esse parâmetro é opcional.

[in, out, optional] pExtraList

Esse parâmetro é reservado para uso futuro e deve ser definido como NULL.

[in, out, optional] pReserved

Esse parâmetro é reservado para uso futuro e deve ser definido como NULL.

Valor retornado

Retorna a confirmação de êxito após a conclusão bem-sucedida. Caso contrário, ele retornará o código de erro específico do DNS apropriado, conforme definido em Winerror.h.

Comentários

O tipo de função DnsModifyRecordsInSet é executado nas etapas a seguir.

  1. Os registros especificados em pDeleteRecords são excluídos . Se pDeleteRecords estiver vazio ou não contiver registros existentes no conjunto atual, a função DnsModifyRecordsInSet irá para a próxima etapa.
  2. Os registros especificados em pAddRecords são adicionados . Se pAddRecords estiver vazio, a operação será concluída sem adicionar nenhum registro.
Para adicionar um novo registro, não forneça registros em pDeleteRecords e forneça o registro a ser adicionado em pAddRecords. Para modificar um registro, especifique o registro que está sendo modificado em pDeleteRecords e adicione a versão modificada desse registro colocando-o em pAddRecords. Para excluir registros, especifique apenas os registros a serem excluídos. Vários registros podem ser adicionados ou excluídos em uma única chamada para DnsModifyRecordsInSet; no entanto, o valor do membro pName em cada DNS_RECORD deve ser o mesmo ou a chamada falhará. Se um registro especificado em pAddRecords já estiver presente, nenhuma alteração ocorrerá.

Se nenhuma lista de servidores for especificada, o servidor de nome padrão será consultado.

Requisitos

   
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 windns.h
Biblioteca Dnsapi.lib
DLL Dnsapi.dll

Confira também

DNS_RECORD

DnsQuery

DnsReplaceRecordSet