Share via


PHCancelAuthenticationRequest (Windows Embedded CE 6.0)

1/6/2010

This function cancels the outstanding authentication request for the specified window. The function will invoke the IP Home Screen application window in order to send the cancellation request to it for proper processing. IP Home Screen is a component of the sample, IP Phone Suite.

Syntax

HRESULT  PHCancelAuthenticationRequest(
    HWND    hwnd
);

Parameters

  • hwnd
    [in] The window the authentication request belongs to.

Return Value

The function returns a variety of HRESULT values, depending on whether the call succeeded or failed. The following table shows additional possible return values.

Value Description

S_OK

Success.

E_FAIL

Failure. It can also fail if it fails to find the IP Home Screen window.

E_HANDLE

The window handle is invalid or NULL.

Remarks

Note

This documentation applies to functionality implemented in sample code for PhCommon. For more information, see PhCommon Reference.

Requirements

Header settingsapi.hpp
Library PhCommon.dll
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Reference

PhCommon Authentication APIs
PhCommon Reference

Concepts

IP Phone Suite