IDirectoryObject::GetObjectAttributes

Gets the definition of one or more specified attributes of the directory service object.

HRESULT GetObjectAttributes(
  LPWSTR * pAttributeNames,  //Names of requested attributes
  DWORD dwNumberAttributes,        //Number of attributes requested
  PADS_ATTR_INFO * ppAttributeEntries,  //Definitions of requested 
                                       // attributes
  DWORD * pdwNumAttributesReturned  //Number of attributes obtained
);
 

Parameters

pAttributeNames

[in] Array of names of the attributes whose definitions are requested. If NULL, all of the object's attributes are requested.

dwNumberAttributes

[in] Size of the pAttributeNames array. If -1, all of the object's attributes are requested.

ppAttributeEntries

[out] Address of a pointer to an array of ADS_ATTR_DEF structures containing the requested attribute definitions. If NULL, no definitions could be obtained from the directory service object.

pdwNumAttributesReturned

[out] Address of a DWORD variable containing the number of attributes that GetObjectAttributes obtained.

Return Values

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

S_OK

The attribute definitions were obtained successfully.

Remarks

The caller is responsible for releasing the array of ADS_ATTR_DEF structures that GetObjectAttributes creates.