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.

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 2008

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: