DS_SCHEMA_GUID_MAPA structure (ntdsapi.h)

Article
03/13/2023

The DS_SCHEMA_GUID_MAP structure contains the results of a call to DsMapSchemaGuids. If DsMapSchemaGuids succeeds in mapping a GUID, DS_SCHEMA_GUID_MAP contains both the GUID and a display name for the object to which the GUID refers.

Syntax

typedef struct {
  GUID  guid;
  DWORD guidType;
#if ...
  CHAR  *pName;
#else
  LPSTR pName;
#endif
} DS_SCHEMA_GUID_MAPA, *PDS_SCHEMA_GUID_MAPA;

Members

guid

GUID structure that specifies the object GUID.

guidType

Indicates the type of GUID mapped by DsMapSchemaGuids.

DS_SCHEMA_GUID_ATTR

The GUID identifies a property.

DS_SCHEMA_GUID_ATTR_SET

The GUID identifies a property set.

DS_SCHEMA_GUID_CLASS

The GUID identifies a type of object.

DS_SCHEMA_GUID_CONTROL_RIGHT

The GUID identifies an extended access right.

DS_SCHEMA_GUID_NOT_FOUND

The GUID cannot be found in the directory service schema.

pName

Pointer to a null-terminated string value that specifies the display name associated with the GUID. This value may be NULL if DsMapSchemaGuids was unable to map the GUID to a display name.

Remarks

Note

The ntdsapi.h header defines DS_SCHEMA_GUID_MAP as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Header	ntdsapi.h