IMailUser::GetIDsFromNames


		Contents Index Topic Contents
	Previous Topic: IMailUser::DeleteProps Next Topic: IMailUser::GetLastError

IMailUser::GetIDsFromNames
HRESULT GetIDsFromNames(
    ULONG  cPropNames,
    LPMAPINAMEID FAR *  lppPropNames,
    ULONG  ulFlags,
    LPSPropTagArray FAR *  lppPropTags
);
Registers named properties with the mail user object.
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
Count of names to register. If lppPropNames is NULL, the cPropNames parameter must be zero.
lppPropNames
MAPINAMEID structure containing the names and their globally unique identifiers (GUIDs).
ulFlags
Bitmask of flags that indicate how the property identifiers should be returned. The following flag can be set:

MAPI_CREATE Creates a property identifier for any name not already mapped. The default is to fail those non-existent property names.

lppPropTags
Returned SPropTagArray of property tags. Must be freed by the caller.

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.