Application Object

The Application object manages information about an application that is being shared.

INmSharableApp Interface

This interface defines the Application object. This interface enables you to obtain the sharable application's window and window title and also to manage its sharing state.

GetHwnd
GetName
GetState
SetState

Back to Application Object

INmSharableApp::GetHwnd

 HRESULT GetHwnd(
    [out] HWND *phwnd);

Retrieves the main window handle to the application.

Returns S_OK if successful, or an error message otherwise.

phwnd: Pointer to a window handle.

Back to INmSharableApp Interface

Back to Application Object

Back to COM Object Listing

INmSharableApp::GetName

HRESULT GetName(
    [out] BSTR *pbstrName);

Retrieves the title string for the application's main window.

Returns one of the following values:

S_OK	Success.
E_POINTER	pbstrName is an invalid pointer.
E_FAIL	The application no longer exists, or internal resources are not available.
E_OUTOFMEMORY	Memory could not be allocated to service the request.

pbstrName: Pointer to a BSTR that contains the shared application's name.

Back to INmSharableApp Interface

Back to Application Object

Back to COM Object Listing

INmSharableApp::GetState

HRESULT GetState(
    [out] NM_SHAPP_STATE *puState);

Retrieves the current state of the application.

Returns one of the following values:

S_OK	Success.
E_POINTER	puState is an invalid pointer.
E_FAIL	The application no longer exists, or internal resources are not available.
E_OUTOFMEMORY	Memory could not be allocated to service the request.

puState

Pointer to an NM_SHAPP_STATE that identifies the shared application state. Possible constants include:

NM_SHAPP_NOT_SHARED	The application is not currently being shared.
NM_SHAPP_SHARED	The application is currently being shared.

Back to INmSharableApp Interface

Back to Application Object

Back to COM Object Listing

INmSharableApp::SetState

HRESULT SetState(
    [in] NM_SHAPP_STATE uState);

Sets the state of the shared application.

Returns one of the following values:

S_OK Success.
E_FAIL The application no longer exists, or internal resources are not available.
E_OUTOFMEMORY Memory could not be allocated to service the request.

uState

NM_SHAPP_STATE that identifies the shared application state. Possible constants include:

NM_SHAPP_NOT_SHARED	The application is not being shared.
NM_SHAPP_SHARED	The application is being shared.

The INmChannelAppShareNotify::StateChanged notification sink will be called when the application's sharing state changes.

Back to INmSharableApp Interface

Back to Application Object

Back to COM Object Listing