IMessenger::Page method
[Page is no longer available for use as of Windows Vista. See Windows Messenger for more information.]
Launches the Page window that is used to page a user, as designated by the input parameter.
Syntax
HRESULT Page(
[in] VARIANT vContact,
[out, retval] IDispatch **ppMWindow
);
Parameters
-
vContact [in]
-
Type: VARIANT
A VARIANT that can take as its value either a VT_BSTR string or a VT_DISPATCH pointer to an existing MessengerContact object. If the input value type is a string, this method creates a new MessengerContact object internally. The string should be the full sign-in name. For a Microsoft .NET Messenger Service contact, this should include the "@" symbol and domain name. If the input value type is a pointer to an existing MessengerContact object (should be type VT_DISPATCH), the existing object is used.
-
ppMWindow [out, retval]
-
Type: IDispatch**
A pointer to a pointer to the IDispatch interface on a MessengerWindow object, which can be accessed through the IMessengerWindow interface that is used to call other automation-accessible properties, such as Height, Width, Top, Left, and Show.
Return value
Type: HRESULT
For a table of all MSGR_E_* constants MSGRConstants, see.
Returns one of the following values.
| Return code | Description |
|---|---|
|
Success. |
|
Could not initiate paging. This contact does not have mobile services enabled. The remote client must configure mobile services through its client options UI before this call will succeed. |
|
ppMWindow is a NULL pointer. |
|
vContact is NULL, points to a NULL string, or points to a string that has a space as the first character. - or - vContact is a VT_BSTR that exceeded 129 characters. - or - vContact is a VT_BSTR and contains a carriage return or linefeed. |
|
Client was not signed in the primary service at the time this method was called. |
|
Could not create an Instant Message window. - or - Called this method while the Sign In dialog box was enabled and visible. - or - Called this method against the local client user. |
Remarks
The Microsoft Exchange Instant Messaging Service (IM) service cannot support this method. Calling this method on an Exchange service contact will fail.
To use this method with Windows Messenger, you must install an add-in component that supports paging.
ppMWindow should be released when it is no longer needed.
Note
This method is available for scripting languages but it returns E_NOTIMPL.
Requirements
| End of client support |
Windows XP |
| End of server support |
Windows Server 2003 |
| Header |
|
| IDL |
|
| DLL |
|