Função DnsReplaceRecordSetA (windns.h)

Artigo
11/20/2024

O tipo de função DnsReplaceRecordSet substitui um conjunto de RR (registro de recurso) existente. Como muitas funções DNS, o tipo de função DnsReplaceRecordSet é implementado em várias formas para facilitar a codificação de caracteres diferente, que é indicada por um sufixo. Com base na codificação de caracteres envolvida, use uma das seguintes funções:

DnsReplaceRecordSetA (_A para codificação ANSI)

DnsReplaceRecordSetW (_W para codificação Unicode)

DnsReplaceRecordSetUTF8 (_UTF8 para codificação UTF 8)

Lembre-se da falta de um sublinhado entre o nome do tipo de função e seu sufixo. Se o DnsReplaceRecordSet tipo de função for chamado sem seu sufixo (A, W ou UTF8), ocorrerá um erro do compilador.

Sintaxe

DNS_STATUS DnsReplaceRecordSetA(
  [in]                PDNS_RECORD pReplaceSet,
  [in]                DWORD       Options,
  [in, optional]      HANDLE      hContext,
  [in, out, optional] PVOID       pExtraInfo,
  [in, out, optional] PVOID       pReserved
);

Parâmetros

[in] pReplaceSet

Um ponteiro para uma estrutura DNS_RECORD que contém o conjunto RR que substitui o conjunto existente. O conjunto de RR especificado é substituído pelo conteúdo de pNewSet. Para excluir um conjunto de RR, especifique o conjunto em pNewSet, mas defina RDATA para NULL.

[in] Options

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

[in, optional] hContext

O 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] pExtraInfo

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 de retorno

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

Observações

Nota

O cabeçalho windns.h define DnsReplaceRecordSet como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	windns.h
biblioteca	Dnsapi.lib
de DLL	Dnsapi.dll

Consulte também

DNS_RECORD

DnsModifyRecordsInSet

Compartilhar via