DoOptionsDialog (Windows Embedded CE 6.0)

Article
01/05/2012

1/6/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.

pntfy
A pointer to IReplNotify:IUnknown.

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

Share via