Export (0) Print
Expand All

DsMapSchemaGuids function

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

Syntax


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

Parameters

hDs [in]

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

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 value

Returns a standard error code that includes the following values.

Return codeDescription
ERROR_SUCCESS

The function succeeded.

ERROR_INVALID_PARAMETER

A parameter is invalid.

ERROR_NOT_ENOUGH_MEMORY

There is insufficient memory available.

ERROR_DS_OPERATIONS_ERROR

An operations error occurred.

 

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Header

Ntdsapi.h

Library

Ntdsapi.lib

DLL

Ntdsapi.dll

Unicode and ANSI names

DsMapSchemaGuidsW (Unicode) and DsMapSchemaGuidsA (ANSI)

See also

DS_SCHEMA_GUID_MAP
DsFreeSchemaGuidMap
Domain Controller and Replication Management Functions

 

 

Show:
© 2015 Microsoft