IDistList::GetIDsFromNames


		Contents Index Topic Contents
	Previous Topic: IDistList::GetHierarchyTable Next Topic: IDistList::GetLastError

IDistList::GetIDsFromNames
HRESULT GetIDsFromNames(
    ULONG cPropNames,
    LPMAPINAMEID FAR * lppPropNames,
    ULONG ulFlags,
    LPSPropTagArray FAR * lppPropTags
);
Provides the property identifiers that correspond to one or more property names.
Returns one of the following values:

S_OK The identifiers for the specified property names were successfully returned.

MAPI_E_NO_SUPPORT The object does not support named properties.

MAPI_E_NOT_ENOUGH_MEMORY Insufficient memory was available to retrieve the identifiers.

MAPI_E_TOO_BIG The operation cannot be performed because it requires too many property tags be returned.

MAPI_W_ERRORS_RETURNED The call succeeded overall, but one or more property identifiers could not be returned. The corresponding property type for each inaccessible property is set to PT_ERROR and its identifier to zero. When this warning is returned, handle the call as successful. To test for this warning, use the FAILED macro.

cPropNames
Value that represents the number of property names pointed to by the lppPropNames parameter. If lppPropNames is NULL, the cPropNames parameter must be zero.
lppPropNames
Address of an array of property names, or NULL. Passing NULL requests property identifiers for all property names in all property sets about which the object has information. The lppPropNames parameter must not be NULL if the MAPI_CREATE flag is set in the ulFlags parameter.
ulFlags
Bitmask of flags that indicate how the property identifiers should be returned. The following flag can be set:

MAPI_CREATE Assigns a property identifier to one or more of the names included in the property name array pointed to by lppPropNames if one has not yet been assigned. Internally registers the identifier in the name-to-identifier mapping table.

lppPropTags
Returned array structure of property tags containing existing or newly assigned property identifiers. The property types for the property tags in this array are set to PT_UNSPECIFIED.

Back to top

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

S_OK	The identifiers for the specified property names were successfully returned.
MAPI_E_NO_SUPPORT	The object does not support named properties.
MAPI_E_NOT_ENOUGH_MEMORY	Insufficient memory was available to retrieve the identifiers.
MAPI_E_TOO_BIG	The operation cannot be performed because it requires too many property tags be returned.
MAPI_W_ERRORS_RETURNED	The call succeeded overall, but one or more property identifiers could not be returned. The corresponding property type for each inaccessible property is set to PT_ERROR and its identifier to zero. When this warning is returned, handle the call as successful. To test for this warning, use the FAILED macro.