InternetConfirmZoneCrossingA function (wininet.h)
Checks for changes between secure and nonsecure URLs. Always inform the user when a change occurs in security between two URLs. Typically, an application should allow the user to acknowledge the change through interaction with a dialog box.
Syntax
DWORD InternetConfirmZoneCrossingA(
[in] HWND hWnd,
[in] LPSTR szUrlPrev,
[in] LPSTR szUrlNew,
[in] BOOL bPost
);
Parameters
[in] hWnd
Handle to the parent window for any required dialog box.
[in] szUrlPrev
Pointer to a null-terminated string that specifies the URL that was viewed before the current request was made.
[in] szUrlNew
Pointer to a null-terminated string that specifies the new URL that the user has requested to view.
[in] bPost
Not implemented.
Return value
Returns one of the following values.
Return code | Description |
---|---|
|
The user confirmed that it was okay to continue, or there was no user input required. |
|
The user canceled the request. |
|
There is not enough memory to carry out the request. |
Remarks
Always inform the user when a change in security level occurs, or you risk subjecting the user to involuntary information disclosure.
Like all other aspects of the WinINet API, this function cannot be safely called from within DllMain or the constructors and destructors of global objects.
Note
The wininet.h header defines InternetConfirmZoneCrossing as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Target Platform | Windows |
Header | wininet.h |
Library | Wininet.lib |
DLL | Wininet.dll |