IMSCSStandardSManager_3_0::get_Mode, put_Mode
.gif "Ee797197.c++_off(en-US,CS.10).gif")
.gif "Ee797197.vb_on(en-US,CS.10).gif")
The Mode property is a read/write Integer that determines how the GetShopperID and PutShopperID methods of the Page object retrieve and store shopper IDs.
Definition
Get method:
HRESULT IMSCSStandardSManager_3_0::get_Mode(int*Mode);
Put method:
HRESULT IMSCSStandardSManager_3_0::put_Mode(intMode);
Parameters
Mode
[in] When putting the property, an Integer that contains the mode.
[out, retval] When getting the property, an Integer used to return the mode.
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
After creating a StandardSManager object, but before calling the GetShopperID or PutShopperID methods, you must initialize the StandardSManager object. To do this, call the InitManager method of the StandardSManager object, specifying the site name and the initialization mode.
The following table shows the values that the mode property integer can take.
| Mode | Behavior |
| 0 | Look only at cookie |
| 1 | Look only at URL |
| 2 | Look at cookie and then URL |
| 3 | Look at URL and then cookie |
The Mode 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.