Contents Index Topic Contents
	Previous Topic: IDistList::GetPropList Next Topic: IDistList::GetSearchCriteria

IDistList::GetProps

HRESULT GetProps(
    LPSPropTagArray lpPropTagArray,
    ULONG ulFlags,
    ULONG FAR * lpcValues,
    LPSPropValue FAR * lppPropArray
);

Retrieves the property tag information for the distribution list items.

• Returns one of the following values:

  S_OK	The property values were successfully retrieved.
  MAPI_W_ERRORS_RETURNED	The call succeeded overall, but one or more properties could not be accessed. The ulPropTag member of the property value for each inaccessible property in the lppPropArray parameter has a property type of PT_ERROR and an identifier of zero. When this warning is returned, the call should be handled as successful. To test for this warning, use the FAILED macro.
  MAPI_E_INVALID_PARAMETER	Zero was passed in the cValues member of the SPropTagArray structure pointed to by lpPropTagArray.

lpPropTagArray

Address of an SPropTagArray structure of properties whose values are to be retrieved. A NULL value specifies that all properties should be retrieved.

ulFlags

MAPI_UNICODE flag. Not supported by Internet Explorer Address Book.

lpcValues

Returned value that represents the number of property values returned. If lppPropArray is NULL, the contents of the lpcValues parameter is zero.

lppPropArray

Returned SPropValue array. Must be freed by the caller.

Back to top

---

 Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.