ADS_DN_WITH_BINARY

The ADS_DN_WITH_BINARY structure associates a distinguished name with its GUID.

typedef struct {

  DWORD dwLength;

  LPBYTE lpBinaryValue;

  LPWSTR pszDNString;
} ADS_DN_WITH_BINARY;

Members

dwLength

The length, in bytes, of the byte array that holds the GUID value.

lpBinaryValue

Pointer to a buffer that contains the GUID of a directory object. For an Active Directory object, this may correspond to the dnWithOctetString or OtherWellKnownObject attribute.

pszDNString

The null-terminated Unicode string that contains the distinguished name of the object associated with the GUID.

Remarks

The distinguished name of an object changes when you move it to a different location. To identify the object, even if it is moved, you can associate its distinguished name to its GUID value. Because the GUID value never changes, this ensures that the identity of the object is not dependent upon its location. Use the ADS_DN_WITH_BINARY structure to perform this type of identity mapping.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Header: Declared in Iads.h.

See Also

ADSI Structures