다음을 통해 공유


DnsModifyRecordsInSet_W 함수(windns.h)

DnsModifyRecordsInSet 함수는 이전에 DNS 서버에 등록되었을 수 있는 RR(리소스 레코드) 집합을 추가, 수정 또는 제거합니다.

많은 DNS 함수와 마찬가지로 DnsModifyRecordsInSet 함수 형식은 다양한 문자 인코딩을 용이하게 하기 위해 여러 형식으로 구현됩니다. 관련된 문자 인코딩에 따라 다음 함수 중 하나를 사용합니다.

  • ANSI 인코딩에 대한 DnsModifyRecordsInSet_A(_A)
  • DnsModifyRecordsInSet_W(유니코드 인코딩에 대한 _W)
  • DnsModifyRecordsInSet_UTF8(UTF 8 인코딩의 경우 _UTF8)

통사론

DNS_STATUS DnsModifyRecordsInSet_W(
  [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
);

매개 변수

[in, optional] pAddRecords

RR 집합에 추가할 R을 포함하는 DNS_RECORD 구조체에 대한 포인터입니다.

[in, optional] pDeleteRecords

RR 집합에서 삭제할 R을 포함하는 DNS_RECORD 구조체에 대한 포인터입니다.

[in] Options

DNS 업데이트 옵션비트맵을 포함하는 값입니다. 옵션을 결합할 수 있으며 모든 옵션은 DNS_UPDATE_SECURITY_USE_DEFAULT재정의합니다.

[in, optional] hCredentials

특정 계정의 자격 증명에 대한 핸들입니다. 보안 동적 업데이트가 필요한 경우에 사용됩니다. 이 매개 변수는 선택 사항입니다.

[in, out, optional] pExtraList

이 매개 변수는 나중에 사용하도록 예약되어 있으며 NULL설정해야 합니다.

[in, out, optional] pReserved

이 매개 변수는 나중에 사용하도록 예약되어 있으며 NULL설정해야 합니다.

반환 값

성공적으로 완료되면 성공 확인을 반환합니다. 그렇지 않으면 Winerror.h에 정의된 적절한 DNS 관련 오류 코드를 반환합니다.

발언

DnsModifyRecordsInSet 함수 형식은 다음 단계에서 실행됩니다.

  1. pDeleteRecords 지정된 레코드가 삭제됩니다. pDeleteRecords 비어 있거나 현재 집합에 있는 레코드가 없는 경우 DnsModifyRecordsInSet 함수는 다음 단계로 이동합니다.
  2. pAddRecords 지정된 레코드가 추가됩니다. pAddRecords 비어 있으면 레코드를 추가하지 않고 작업이 완료됩니다.
새 레코드를 추가하려면 pDeleteRecords레코드를 제공하지 않고 pAddRecords추가할 레코드를 제공합니다. 레코드를 수정하려면 pDeleteRecords수정되는 레코드를 지정한 다음, pAddRecords배치하여 해당 레코드의 수정된 버전을 추가합니다. 레코드를 삭제하려면 삭제할 레코드만 지정합니다. DnsModifyRecordsInSet단일 호출에서 여러 레코드를 추가하거나 삭제할 수 있습니다. 그러나 각 DNS_RECORD pName 멤버의 값은 동일해야 합니다. 그렇지 않으면 호출이 실패합니다. pAddRecords 지정된 레코드가 이미 있는 경우 변경되지 않습니다.

서버 목록을 지정하지 않으면 기본 이름 서버가 쿼리됩니다.

요구 사항

요구
지원되는 최소 클라이언트 Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버 Windows 2000 Server [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 windns.h
라이브러리 Dnsapi.lib
DLL Dnsapi.dll

참고 항목

DNS_RECORD

dnsQuery

dnsReplaceRecordSet