IMessengerWindow::IsClosed Property
Deprecated. Retrieves a Boolean value that indicates the open or closed state of the window.
Syntax
HRESULT IMessengerWindow::get_IsClosed(VARIANT_BOOL *pBoolClose);
Parameters
- pBoolClose
Pointer to a VARIANT_BOOL that defines the open and closed state for the Messenger window with one of the following possible values:
Possible Values
VARIANT_TRUE Messenger window is closed. This means that it has no HWND or window handle either numerically or on a system level. Attempts to reference some Microsoft Win32 functions against the window will fail. The client can continue to exist as a running executable and can potentially be seen in process lists and in minimized form in the notification area or system tray. VARIANT_FALSE Messenger application window is either visible or minimized and has a valid HWND or window handle.
Return Value
Returns one of the following values:
S_OK Success. RPC_X_NULL_REF_POINTER pBoolClose is a NULL pointer.
Remarks
This method is useful when this interface is called against the Messenger application window. The method can be called against a conversation window, but will return FALSE for any case in which a valid MessengerWindow object existed to call the method against. If the conversation window that corresponds to the object had been closed by client action, then the object would have become unassigned and thrown an object reference error. A minimized window is considered to be closed or not closed based on the visibility settings through Show, Close, or equivalent user interface (UI) settings.
Note This property is available for scripting languages.
Important IMessengerWindow::IsClosed is no longer available in Windows Vista. See Windows Messenger for more information.
See Also