Compartilhar via


IXRVisualHost::StartDialog (Compact 2013)

3/28/2014

This method starts this visual host as a modal dialog box, which requires the user to supply information or dismiss the dialog box before enabling the application to continue.

Syntax

virtual HRESULT STDMETHODCALLTYPE StartDialog(
    UINT* pExitCode
) = 0;

Parameters

  • pExitCode
    [in] Pointer to an integer value that provides the exit code you can later pass into IXRVisualHost::EndDialog.

Return Value

Returns an HRESULT that indicates success or failure.

Returns XR_E_INVALID_THREAD_ACCESS if this method was called from a thread different from the thread on which the system was initialized. A visual host can only be accessed on the thread that it was created on. Notice that most XAML for Windows Embedded APIs can only be accessed from a single thread.

Returns XR_E_INVALID_STATE if this method was called on an object in an invalid state, such as a host that was already destroyed, or a dialog that was closed without calling EndDialog.

.NET Framework Equivalent

None.

Requirements

Header

XamlRuntime.h

sysgen

SYSGEN_XAML_RUNTIME

See Also

Reference

IXRVisualHost