Directory Services

DSEnumAttributesCallback

The DSEnumAttributesCallback function is an application-defined callback function that is called once for each attribute enumerated by the IDsDisplaySpecifier::EnumClassAttributes method. A pointer to this function is supplied as the pcbEnum parameter in IDsDisplaySpecifier::EnumClassAttributes. DSEnumAttributesCallback is a placeholder for the application-defined function name.

HRESULT CALLBACK DSEnumAttributesCallback(
  LPARAM lParam,
  LPCWSTR pszAttributeName,
  LPCWSTR pszDisplayName,
  DWORD dwFlags
);

Parameters

lParam
Contains an application-defined parameter passed as the lParam parameter to the IDsDisplaySpecifier::EnumClassAttributes method.
pszAttributeName
Pointer to a null-terminated Unicode string that contains the LDAP name of the attribute.
pszDisplayName
Pointer to a null-terminated Unicode string that contains the localized name of the attribute.
dwFlags
Contains a set of flags that define the behavior or state of the attribute. This can be zero or the following value:
Value Meaning
DSECAF_NOTLISTED The attribute is hidden in the user interface.

Return Values

Returns S_OK to continue the enumeration or any failure code, such as E_FAIL, to terminate the enumeration.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Header: Declared in Dsclient.h.

See Also

IDsDisplaySpecifier::EnumClassAttributes