3.1.4.19 R_DnssrvEnumRecords4 (Opnum 18)

The R_DnssrvEnumRecords4 method enumerates DNS records on a zone or a zone scope in a virtualization instance, if specified. The DNS server SHOULD<294> implement R_DnssrvEnumRecords4.

All parameters are as specified by the R_DnssrvEnumRecords3 method (section 3.1.4.12) with the following exceptions:

    LONG R_DnssrvEnumRecords4(
      [in]                                  handle_t      hBindingHandle,
      [in]                                  DWORD         dwClientVersion,
      [in]                                  DWORD         dwSettingFlags,
      [in, unique, string]                  LPCWSTR       pwszServerName,
      [in, unique, string]                  LPCWSTR       pwszVirtualizationInstanceID,
      [in, unique, string]                  LPCSTR        pszZone,
      [in, unique, string]                  LPCWSTR       pwszZoneScope,
      [in, unique, string]                  LPCSTR        pszNodeName,
      [in, unique, string]                  LPCSTR        pszStartChild,
      [in]                                  WORD          wRecordType,
      [in]                                  DWORD         fSelectFlag,
      [in, unique, string]                  LPCSTR        pszFilterStart,
      [in, unique, string]                  LPCSTR        pszFilterStop,
      [out]                                 PDWORD        pdwBufferLength,
      [out, size_is(, *pdwBufferLength)]    PBYTE *        ppBuffer
    );

pwszVirtualizationInstanceID: A pointer to a null-terminated character string that contains the name of the virtualization instance under which zone and zone scope records are to be enumerated. For operations specific to a particular zone or zone scope, details must be given in pszZone and pwszZoneScope as specified in section 3.1.4.12. If the value pwszVirtualizationInstanceID is NULL, the API gives the same behavior as R_DnssrvEnumRecord3.

When processing this call, the server MUST perform the same actions as for the R_DnssrvEnumRecords3 method (section 3.1.4.12). If unable to perform the operation returns error EPT_S_CANT_PERFORM_OP (0x000006D8) ([MS-ERREF] section 2.2).