DsMapSchemaGuidsW function (ntdsapi.h)

Article
02/22/2024

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

Syntax

NTDSAPI DWORD DsMapSchemaGuidsW(
  [in]  HANDLE              hDs,
  [in]  DWORD               cGuids,
  [in]  GUID                *rGuids,
  [out] DS_SCHEMA_GUID_MAPW **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