Directory Services

DsMapSchemaGuids

The DsMapSchemaGuids function converts GUIDs of directory service schema objects to their 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 values 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 that contain the display names of the objects in rGuids. This array must be deallocated using DsFreeSchemaGuidMap.

Return Values

Returns a standard error code that includes the following values.
Return Code Description
ERROR_SUCCESS The function succeeded.
ERROR_INVALID_PARAMETER A parameter is incorrect.
ERROR_NOT_ENOUGH_MEMORY There is insufficient memory available.
ERROR_DS_OPERATIONS_ERROR An operations error occurred.

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.
Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000/XP.
Header: Declared in Ntdsapi.h.
Library: Use Ntdsapi.lib.

See Also

DS_SCHEMA_GUID_MAP, DsFreeSchemaGuidMap, Domain Controller and Replication Management Functions