Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

The FileAsproperty gets or sets the filing string for a contact.

To set the value of the FileAsproperty, call the property method described here.

To get the value of the FileAsproperty, see the IContact::get_FileAsproperty method.

Syntax 

HRESULT put_FileAs(
   BSTR 
pwsz
);

Parameters

pwsz

[in] Reference to the filing string. For information on the BSTRtype, see BSTR.

Return Value

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 FirstNameor LastName(or CompanyNameif there are no values for FirstName and LastName), Outlook Mobile automatically updates the FileAsvalue to match.

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

Requirements

Header pimstore.h
Library Pimstore.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also