_SimpleFindSearchInfo::get_user_firstname, put_user_firstname
.gif "Ee796530.c++_off(en-US,CS.10).gif")
.gif "Ee796530.vb_on(en-US,CS.10).gif")
The user_firstname property is a read/write Variant that contains the first name of the user to search for; if left null, the first name of the user does not become part of the search criteria.
Definition
Get method:
HRESULT _SimpleFindSearchInfo::get_user_firstname(VARIANT*user_firstname);
Put method:
HRESULT _SimpleFindSearchInfo::put_user_firstname(VARIANT*user_firstname);
Parameters
user_firstname
[in] When putting the property, a VARIANT that contains the first name of the user to search for.
[out, retval] When getting the property, a VARIANT used to return the first name of the user to search for.
Return Values
These methods return an HRESULT indicating whether they completed successfully. See the Error Values section for more details.
Error Values
These methods return S_OK (0x00000000) to indicate success and standard COM HRESULT error values to indicate failure. For more information about standard COM errors, see Standard COM Errors. Additional information may be available using the global Err object, which can be accessed using the API function GetErrorInfo. In particular, the GetDescription method of the IErrorInfo interface may return a text description of the error.
Remarks
The user_firstname parameter contains valid data only if the property is accessed successfully.
For more information about memory ownership issues related to COM property and method parameters, see Managing COM Parameter Memory.