dpext.h

基于wince的smartphone Home Screen下用Dial Paser输入特定字符串进入特定程序

/*++
THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
PARTICULAR PURPOSE.
Copyright (c) Microsoft Corporation

--*/

#ifndef _DPEXTENS_H_
#define _DPEXTENS_H_

// Dial Parser Extensibility response recommendations
#define DPEF_ALLOW_DIAL_REQUEST 0x01
#define DPEF_ABORT_DIAL_REQUEST 0x02
#define DPEF_REQUEST_NOT_SECURE 0x04

extern "C" __declspec(dllexport) BOOL IsImmediateDialRequestRequired(LPCTSTR lpszDialString);
extern "C" __declspec(dllexport) DWORD PreprocessDialRequest(HWND hWnd, LPCTSTR lpszDialString, BOOL fSecure);

/****************************************************************************

  NOTES:
  
	The Dial Parser offers the ability to extend its functionality
	by means of a DLL which implements two functions as described
	below.
	
      An OEM implementor should include an entry in the registry, in
      the appropriate .reg file, which points to the name of the DLL
      which exports these functions.  For example:
	  
		[HKEY_LOCAL_MACHINE\Software\Microsoft\DialParser\]
		"DLL-OEM"="DialParsExtOEM.dll"
		
		  (The name of the DLL can be anything, but the registry key must
		  be as shown.)
		  
			****************************************************************************
			
			  FUNCTION: IsImmediateDialRequestRequired
			  
				SIGNATURE:
				BOOL IsImmediateDialRequestRequired(LPCTSTR lpszDialString);
				
				  PURPOSE:
				  Give Dial Parser Extensibility a chance to decide whether
				  the framework should regard the digits collected so far as
				  an actionable dial string.
				  
					PARAMETERS:
					lpszDialString - The digits collected so far
					
					  RETURNS:
					  TRUE if lpszDialString is a complete dial request, meaning
					  that no additional digits need to be collected and
					  the Talk button does not need to be pressed in order
					  for a meaningful dial action to take place
					  FALSE otherwise
					  
						****************************************************************************
						
						  FUNCTION: PreprocessDialRequest
						  
							SIGNATURE:
							DWORD PreprocessDialRequest(HWND hWnd, LPCTSTR lpszDialString, BOOL fSecure);
							
							  PURPOSE:
							  Give Dial Parser Extensibility a chance to intercept the
							  Dial Request.  If the DLL chooses not to, the framework
							  will send the Dial Request to RIL.
							  
								The implementor can take whatever action is appropriate,
								including nothing at all, before returning.  The implementor
								may wish to use hWnd to display a MessageBox, or may wish to
								use tapiRequestMakeCall to issue a call to a number other
								than the one that was entered, etc.
								
								  Typically, if the DLL takes action on its own, it will
								  return DPEF_ABORT_DIAL_REQUEST, and if it does not take
								  action on its own, it will return DPEF_ALLOW_DIAL_REQUEST.
								  However, this is a recommendation, not a requirement.
								  
									PARAMETERS:
									hWnd           - A window handle, typically used as a
									parent window for MessageBoxes
									lpszDialString - The digits collected so far
									fSecure        - Whether the string represents a secure
									call request
									
									  RETURNS:
									  DPEF_ALLOW_DIAL_REQUEST - the framework should do whatever
									  it would normally do
									  DPEF_ABORT_DIAL_REQUEST - the framework should assume that
									  the dial request has been handled
									  and stop processing it further
									  
****************************************************************************/

#endif // _DPEXTENS_H_