DsMapSchemaGuids

The DsMapSchemaGuids function converts GUIDs of directory service objects to their "friendly" display names.

DWORD DsMapSchemaGuids(
  HANDLE hDs,
  DWORD cGuids,
  GUID *rGuids,
  DS_SCHEMA_GUID_MAP **ppGuidMap
);

Parameters

hDs

[in] Bind handle to the directory service.

cGuids

[in] Indicates the number of elements in rGuids.

rGuids

[in] Pointer to an array of GUID structures for the objects to be mapped.

ppGuidMap

[out] Pointer to a variable that receives a pointer to an array of DS_SCHEMA_GUID_MAP structures containing the display names of the objects in rGuids. This array must be deallocated using DsFreeSchemaGuidMap.

Return Values

If the function returns a list of object display names, the return value is ERROR_SUCCESS.

If the function fails, the return value can be one of the following error codes.

ERROR_INVALID_PARAMETER

A parameter is incorrect.

ERROR_NOT_ENOUGH_MEMORY

There is insufficient memory available.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Ntdsapi.h.
  Library: Included as a resource in Ntdsapi.dll.
  Unicode: Implemented as Unicode and ANSI versions on Windows 2000.

See Also

DC and Replication Management Functions, DsFreeSchemaGuidMap, DS_SCHEMA_GUID_MAP