ADSPROPINITPARAMS structure (adsprop.h)

The ADSPROPINITPARAMS structure is used with the ADsPropGetInitInfo function to obtain object data that a display specifier applies to.

Syntax

typedef struct _ADSPROPINITPARAMS {
  DWORD            dwSize;
  DWORD            dwFlags;
  HRESULT          hr;
  IDirectoryObject *pDsObj;
  LPWSTR           pwzCN;
  PADS_ATTR_INFO   pWritableAttrs;
} ADSPROPINITPARAMS, *PADSPROPINITPARAMS;

Members

dwSize

The size, in bytes, of the ADSPROPINITPARAMS structure. Set this value before calling ADsPropGetInitInfo.

dwFlags

Reserved.

hr

Contains an HRESULT value that specifies the result of the bind/get operation. If this value does not equal S_OK, then the remaining structure members are not initialized and should be ignored.

pDsObj

Pointer to an IDirectoryObject interface that represents the directory object that the display specifier applies to. Do not release this interface.

pwzCN

Pointer to a null-terminated Unicode string that contains the common name of the directory object.

pWritableAttrs

Pointer to an ADS_ATTR_INFO structure that contains attribute data for the directory object.

Remarks

The ADsPropGetInitInfo function allocates memory for the pwzCN and pWritableAttrs members. This memory is freed by the system after all display specifier objects are destroyed. The reference count for the interface pointer in pDsObj is not incremented by calling ADsPropGetInitInfo, so the interface must not be released by the caller.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Header	adsprop.h

See also

ADS_ATTR_INFO

ADsPropGetInitInfo

IDirectoryObject