DsGetDcNext (netapi32)
Last changed: 179.60.150.123

.
Summary
The DsGetDcNext function retrieves the next domain controller in a domain controller enumeration operation.

C# Signature:

using HANDLE = System.IntPtr;
using DWORD = System.UInt32;

[DllImport("netapi32.dll", SetLastError=true)]
internal static extern DWORD DsGetDcNext(
     HANDLE GetDcContextHandle,
     IntPtr SockAddressCount,
     IntPtr SockAddresses, //must free this if using (SocketAddressCount > 1)
     out IntPtr DnsHostName //will have to marshal this one manually
     );

VB Signature:

Declare Function DsGetDcNext Lib "netapi32.dll" (TODO) As TODO

User-Defined Types:

None.

Notes:

GetDcContextHandle

in Contains the domain controller enumeration context handle provided by the DsGetDcOpen function.

SockAddressCount

[out, optional] Pointer to a ULONG value that receives the number of elements in the SockAddresses array. If this parameter is NULL, socket addresses are not retrieved.

SockAddresses

[out, optional] Pointer to an array of SOCKET_ADDRESS structures that receives the socket address data for the domain controller. SockAddressCount receives the number of elements in this array.

All returned addresses will be of type AF_INET or AF_INET6. The sin_port member contains the port from the server record. A port of 0 indicates no port is available from DNS.

The caller must free this memory when it is no longer required by calling LocalFree.

This parameter is ignored if SockAddressCount is NULL.

DnsHostName

[out, optional] Pointer to a string pointer that receives the DNS name of the domain controller. This parameter receives NULL if no host name is known. The caller must free this memory when it is no longer required by calling NetApiBufferFree.

Tips & Tricks:

Please add some!

Sample Code:

Please add some!

Alternative Managed API:

Do you know one? Please contribute it!

Documentation
DsGetDcNext on MSDN