IContact::get_FileAs

Send Feedback

The FileAs property gets or sets the filing string for a contact.

To get the value of the FileAs property, call the property method described here.

To set the value of the FileAs property, see the IContact::put_FileAs property method.

Syntax

HRESULT get_FileAs(
  BSTR * ppwsz
);

Parameters

  • ppwsz
    [out] Reference to the filing string.

Return Values

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

  • S_OK
    The method completed successfully.

Remarks

Maximum length is 1022 characters.

Outlook Mobile automatically defaults the filing string to "LastName, FirstName".

If you update a Contact's FirstName or LastName (or CompanyName if there are no values for FirstName and LastName), Outlook Mobile automatically updates the FileAs value to match.

If you set FileAs, the new value is not overwritten until you call Save.

Requirements

Pocket PC: Pocket PC 2000 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: pimstore.h
Library: pimstore.lib

See Also

IContact | Pocket Outlook Object Model API Interfaces | Pocket Outlook Object Model API Enumerations

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.