ShellPropSheetDialog Struct Reference

Classes
struct	DATA

Public Types
typedef void(CALLBACK *	PFNINITIALIZE) (LPCWSTR InitString, IDataObject *pDO, HKEY *hKeys, UINT *cKeys)

Static Public Member Functions
static HRESULT	Show (const CLSID *pClsidDefault, IDataObject *pDO, PFNINITIALIZE InitFunc, LPCWSTR InitString)
static void	FreeData (DATA *pData)
static HRESULT	ShowAsync (const CLSID *pClsidDefault, IDataObject *pDO, PFNINITIALIZE InitFunc, LPCWSTR InitString)
static DWORD CALLBACK	ShowPropertiesThread (LPVOID Param)

Detailed Description

Definition at line 27 of file item_prop.cpp.

Member Typedef Documentation

PFNINITIALIZE

typedef void(CALLBACK * ShellPropSheetDialog::PFNINITIALIZE) (LPCWSTR InitString, IDataObject *pDO, HKEY *hKeys, UINT *cKeys)

Definition at line 29 of file item_prop.cpp.

Member Function Documentation

FreeData()

static void ShellPropSheetDialog::FreeData ( DATA *  pData )

inlinestatic

Definition at line 56 of file item_prop.cpp.

    {
        if (pData->InitString)
            SHFree(pData->InitString);
        SHFree(pData);
    }

Referenced by ShowAsync(), and ShowPropertiesThread().

Show()

static HRESULT ShellPropSheetDialog::Show ( const CLSID *  pClsidDefault, IDataObject *  pDO, PFNINITIALIZE  InitFunc, LPCWSTR  InitString  )

inlinestatic

Definition at line 32 of file item_prop.cpp.

    {
        HRESULT hr;
        CRegKeyHandleArray keys;
        if (InitFunc)
            InitFunc(InitString, pDO, keys, keys);
        WCHAR szCaption[MAX_PATH], *pszCaption = NULL;
        if (SUCCEEDED(SHELL_GetCaptionFromDataObject(pDO, szCaption, _countof(szCaption))))
            pszCaption = szCaption;
        hr = SHOpenPropSheetW(pszCaption, keys, keys, pClsidDefault, pDO, NULL, NULL) ? S_OK : E_FAIL;
        return hr;
    }

Referenced by ShowPropertiesThread().

ShowAsync()

static HRESULT ShellPropSheetDialog::ShowAsync ( const CLSID *  pClsidDefault, IDataObject *  pDO, PFNINITIALIZE  InitFunc, LPCWSTR  InitString  )

inlinestatic

Definition at line 63 of file item_prop.cpp.

    {
        DATA *pData = (DATA*)SHAlloc(sizeof(*pData));
        if (!pData)
            return E_OUTOFMEMORY;
        ZeroMemory(pData, sizeof(*pData));
        pData->InitFunc = InitFunc;
        if (InitString && FAILED(SHStrDupW(InitString, &pData->InitString)))
        {
            FreeData(pData);
            return E_OUTOFMEMORY;
        }
        if (pClsidDefault)
        {
            pData->ClsidDefault = *pClsidDefault;
            pData->pClsidDefault = &pData->ClsidDefault;
        }
        HANDLE hEvent = pData->hEvent = CreateEventW(NULL, TRUE, FALSE, NULL);
 
        HRESULT hr = S_OK;
        if (pDO)
            hr = CoMarshalInterThreadInterfaceInStream(IID_IDataObject, pDO, &pData->pObjStream);
 
        const UINT flags = CTF_COINIT | CTF_PROCESS_REF | CTF_INSIST;
        if (SUCCEEDED(hr) && !SHCreateThread(ShowPropertiesThread, pData, flags, NULL))
        {
            if (pData->pObjStream)
                pData->pObjStream->Release();
            hr = E_FAIL;
        }
 
        if (SUCCEEDED(hr))
        {
            if (hEvent)
            {
                DWORD index;
                // Pump COM messages until the thread can create its own IDataObject (for CORE-19933).
                // SHOpenPropSheetW is modal and we cannot wait for it to complete.
                CoWaitForMultipleHandles(COWAIT_DEFAULT, INFINITE, 1, &hEvent, &index);
                CloseHandle(hEvent);
            }
        }
        else
        {
            FreeData(pData);
        }
        return hr;
    }

Referenced by SHELL32_ShowFilesystemItemPropertiesDialogAsync(), SHELL32_ShowShellExtensionProperties(), and SHMultiFileProperties().

ShowPropertiesThread()

static DWORD CALLBACK ShellPropSheetDialog::ShowPropertiesThread ( LPVOID  Param )

inlinestatic

Definition at line 113 of file item_prop.cpp.

    {
        DATA *pData = (DATA*)Param;
        CComPtr<IDataObject> pDO, pLocalDO;
        if (pData->pObjStream)
            CoGetInterfaceAndReleaseStream(pData->pObjStream, IID_PPV_ARG(IDataObject, &pDO));
        if (pDO && SUCCEEDED(SHELL_CloneDataObject(pDO, &pLocalDO)))
            pDO = pLocalDO;
        if (pData->hEvent)
            SetEvent(pData->hEvent);
        Show(pData->pClsidDefault, pDO, pData->InitFunc, pData->InitString);
        FreeData(pData);
        return 0;
    }

Referenced by ShowAsync().

---

The documentation for this struct was generated from the following file:

• dll/win32/shell32/dialogs/item_prop.cpp