Share via


DoOptionsDialog

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method shows the Settings dialog box if SSP is not enabled.

Syntax

HRESULT DoOptionsDialog (
  HWND hwndParent, 
  LPCSTR lpszObjType, 
  IReplNotify* pntfy
);

Parameters

  • hwndParent
    HWND the SSP should use to parent any dialog box it displays when this function is called.
  • lpszObjType
    The name of the folder to show settings.

Return Value

The following table shows the return values for this function.

Return value Description

NOERROR

User selected. OK to save the changes.

RERR_CANCEL

User selected. Cancel.

Remarks

The IReplStore::Initialize method might not have been called prior to this method being called, so you must not use any internal variables that depend on IReplStore::Initialize being called.

The SSP must be marked "Version 3" to use this interface. When you register the SSP, create a DWORD registry value Version with a value of 0x00030000 under the HKCR\<prog id> registry key.

The following registry key example shows how to register the SSP:

[HKEY_CLASSES_ROOT\MS.WinCE.StockPor2]
@="StockPor"
"Display Name"="Stock Sample"
"Version"=dword:00030000:

Code Example

The following code example demonstrates how to use DoOptionsDialog.

Note

To make the following code example easier to read, security checking and error handling are not included. This code example should not be used in a release configuration unless it has been modified to include them.

HRESULT DoOptionsDialog(HWND hwndParent, LPCSTR pszObjType, IReplNotify * pntfy )
{
    // The IReplStore::Initialize function might not have been called prior
    // to this function being called, so you must not use internal
    // variables that depend upon IReplStore::Initialize being called.
    //  If your SSP supports multiple folders, then the folder selected is pszObjType.
    HRESULT hrReturn = S_OK;
    int nSave;
    nSave = MessageBox(hwndParent, _T("Options for my SSP. Click Yes to save changes."), _T("My SSP"), MB_YESNO);
    if (IDYES == nSave)
    {
        hrReturn = S_OK;
    }
    else
    {
        hrReturn = RERR_CANCEL;
    }
    return hrReturn;
}

Requirements

Header cesync.h
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also

Reference

IReplStore2
OnSSPEnable
OnSSPDisable