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 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Redistributable

Active Directory Client Extension on Windows NT 4.0 and Windows Me/98/95

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:
© 2014 Microsoft