DsMapSchemaGuidsA function (ntdsapi.h)

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

Syntax

NTDSAPI DWORD DsMapSchemaGuidsA(
  [in]  HANDLE              hDs,
  [in]  DWORD               cGuids,
  [in]  GUID                *rGuids,
  [out] DS_SCHEMA_GUID_MAPA **ppGuidMap
);

Parameters

[in] hDs

Contains a directory service handle obtained from either the DSBind or DSBindWithCred function.

[in] cGuids

Indicates the number of elements in rGuids.

[in] rGuids

Pointer to an array of GUID values for the objects to be mapped.

[out] ppGuidMap

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 value

Returns a standard error code that includes the following values.

Remarks

Note

The ntdsapi.h header defines DsMapSchemaGuids 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
Target Platform Windows
Header ntdsapi.h
Library Ntdsapi.lib
DLL Ntdsapi.dll

See also

DS_SCHEMA_GUID_MAP

Domain Controller and Replication Management Functions

DsFreeSchemaGuidMap