ADSPROPINITPARAMS

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

typedef struct {

  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

Not currently used.

hr

Contains an HRESULT value that specifies the result of the bind/fetch 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.

Windows XP: Multi-select property pages will always return NULL for the pDsObj and pWritableAttrs structure members.

Requirements

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

See Also

ADsPropGetInitInfo, IDirectoryObject, ADS_ATTR_INFO