conadevicemanagement.cs

以前做NOKIA手机与PC通信时所参考的源代码,里面包括两个程序,一个是手机文件夹浏览源码,另一个手机SIS安装程序.

        // ECONA_NOT_INITIALIZED
        // ECONA_UNKNOWN_ERROR
        //
        public static extern int CONARenameFriendlyName(
            int hDMHandle,
            [MarshalAs(UnmanagedType.LPWStr)] string pstrSerialNumber,
            [MarshalAs(UnmanagedType.LPWStr)] string pstrNewFriendlyName
            );

        [DllImport("ConnAPI", CharSet = CharSet.Ansi, SetLastError = true, ExactSpelling = true)]
        //=========================================================

        //=========================================================
        // CONARegisterNotifyCallback
        //
        // Description:
        //  Registers notification call back function to connectivity API
        //
        // Parameters:
        //  hDMHandle       [in] Device manager handle
        //  iState          [in] Used to define the action
        //                       API_REGISTER used in registeration
        //                       API_REGISTER used in removing the registeration
        //  pfnNotify       [in] Function pointer of the call back method
        //
        // Return values:
        // CONA_OK
        // ECONA_INVALID_POINTER
        // ECONA_INVALID_PARAMETER
        // ECONA_NOT_INITIALIZED
        // ECONA_UNKNOWN_ERROR
        //
        //=========================================================
        public static extern int CONARegisterNotifyCallback(
            int hDMHandle,
            int iState,
            CONADefinitions.DeviceNotifyCallbackDelegate pfnNotify
            );

        [DllImport("ConnAPI", CharSet = CharSet.Ansi, SetLastError = true, ExactSpelling = true)]
        //=========================================================
        // CONASearchDevices 
        //
        // Description:
        //	CCONASearchDevices functions search all devices from the target media. 
        //  The target media that can be used is Bluetooth at the moment.
        //
        //  CONASearchDevices allocates and sets devices information to 
        //  CONAPI_CONNECTION_INFO structs and returns pointer to structs.  
        //  Connectivity API-user MUST releases the returned pointer by calling the 
        //  CONAFreeConnectionInfoStructures function. 
        //
        //	Every CONAPI_CONNECTION_INFO struct includes the media and device information.
        //	The struct's dwState parameter defines the paired and trusted information from 
        //  device. It has the following values:
        //  Parameter value					Description					Macros for check the values 
        //																(If value is true, macro returns 1)
        //	CONAPI_DEVICE_UNPAIRED			Device in not paired.		CONAPI_IS_DEVICE_UNPAIRED(dwState)
        //	CONAPI_DEVICE_PAIRED			Device is paired.			CONAPI_IS_DEVICE_PAIRED(dwState)
        //	CONAPI_DEVICE_PCSUITE_TRUSTED	Device is PC Suite trusted.	CONAPI_IS_PCSUITE_TRUSTED(dwState)
        //
        //	Connectivity API can add more values afterwards so Connectivity API-user should 
        //	always use defined macros to check those values!

        //
        // Parameters:
        //	hDMHandle				[in] Existing device management handle.
        //	dwSearchOptions			[in] Search options values:
        //			API_MEDIA_BLUETOOTH: Get devices from bluetooth media. 
        //				This value must be used.
        //			CONAPI_ALLOW_TO_USE_CACHE: Get all devices from cache if available. 
        //				If cache is not available function fails with error: ECONA_CACHE_IS_NOT_AVAILABLE.
        //				This value is optional and can be used with other values.
        //			One of the next values can be used at the time:
        //			CONAPI_GET_ALL_PHONES: Get all phones from target media. Includes unpaired, 
        //				paired and PC Suite trusted phones. 
        //			CONAPI_GET_PAIRED_PHONES:Get all paired phones from target media. Includes 
        //				paired (and PC Suite trusted) phones. 
        //			CONAPI_GET_TRUSTED_PHONES:Get all PC Suite trusted phones from target media. 
        //				Includes all PC Suite trusted phones, which are paired.
        //	dwSearchTime			[in]  Maximum search time in seconds. Note: Bluetooth device
        //			discovery can takes several minutes if there are a lot of devices on range!
        //	pfnSearchNotify			[in]  Pointer to search notification callback function. Value
        //			can be NULL if notification is not needed.
        //	pdwNumberOfStructures	[out] Number of CONAPI_CONNECTION_INFO structures. 
        //	ppConnInfoStructures	[out] Pointer to CONAPI_CONNECTION_INFO structure(s). 

        //	hDMHandle			[in] Device manager handle
        //	pstrSerialNumber	[in] Serial number of the device.
        //	pstrNewFriendlyName [in] New Device Friendly Name .
        //
        // Return values:
        // CONA_OK
        // ECONA_INVALID_POINTER
        // ECONA_INVALID_HANDLE
        // ECONA_DEVICE_NOT_FOUND
        // ECONA_FAILED_TIMEOUT
        // ECONA_NO_CONNECTION_VIA_MEDIA
        // ECONA_MEDIA_IS_NOT_WORKING
        // ECONA_CACHE_IS_NOT_AVAILABLE
        // ECONA_SUSPEND
        // ECONA_NOT_ENOUGH_MEMORY
        // ECONA_NOT_INITIALIZED
        // ECONA_NOT_SUPPORTED_PC
        // ECONA_CANCELLED
        // ECONA_UNKNOWN_ERROR

        //=========================================================
        public static extern int CONASearchDevices(
            int hDMHandle,
            int dwSearchOptions,
            int dwSearchTime,
            CONADefinitions.SearchCallbackDelegate pfnSearchNotify,
            ref int pdwNumberOfStructures,
            ref System.IntPtr pConnInfoStructures
            );

        [DllImport("ConnAPI", CharSet = CharSet.Ansi, SetLastError = true, ExactSpelling = true)]
        //=========================================================
        // CONAFreeConnectionInfoStructures
        //
        // Description:
        //	CONAFreeDeviceStructure releases the CONAPI_CONNECTION_INFO structs, 
        //	which CONASearchDevices function is allocated.
        //
        // Parameters:
        //	dwNumberOfStructures	[in] Number of CONAPI_CONNECTION_INFO structures.
        //	ppConnInfoStructures	[in] Pointer to CONAPI_CONNECTION_INFO structure(s).
        //
        // Return values:
        //	CONA_OK
        //	ECONA_INVALID_POINTER
        //	ECONA_INVALID_PARAMETER
        //	ECONA_UNKNOWN_ERROR
        public static extern int CONAFreeConnectionInfoStructures(
            int dwNumberOfStructures,
            ref System.IntPtr pConnInfoStructures
            );

        [DllImport("ConnAPI", CharSet = CharSet.Ansi, SetLastError = true, ExactSpelling = true)]
        //=========================================================

        //=========================================================
        // CONAChangeDeviceTrustedState
        //
        // Description:
        //	CONAChangeDeviceTrustedState functions changes device's 
        //	trusted state. It has the following operation values:
        //	Value							Description
        //	CONAPI_PAIR_DEVICE				Pair device.
        //	CONAPI_UNPAIR_DEVICE			Unpair device from Bluetooth stack.
        //	CONAPI_SET_PCSUITE_TRUSTED		Set device to PC Suite trusted state.
        //		System recognise the device and sets it to trusted state. Connectivity 
        //		API starts sends device notification from device.Note: Device must be 
        //		paired. Value can be used with CONAPI_PAIR_DEVICE. 
        //	CONAPI_SET_PCSUITE_UNTRUSTED	Remove PC Suite trusted information from 
        //		System. Connectivity API does not send device notification from device 
        //		anymore.Note: Device can be paired or unpaired state. Value can be used 
        //		with CONAPI_UNPAIR_DEVICE.

        //
        // Parameters:
        //	hDMHandle			[in] Existing device management handle.
        //	dwTrustedOperation	[in] Operation values: 
        //								CONAPI_PAIR_DEVICE
        //								CONAPI_UNPAIR_DEVICE
        //								CONAPI_SET_PCSUITE_TRUSTED 
        //								CONAPI_SET_PCSUITE_UNTRUSTED
        //	pstrAddress			[in] Device address. If device is connected via Bluetooth 
        //				media, address must be Device BT address (see pstrAddress parameter 
        //				from CONAPI_CONNECTION_INFO Structure)
        //	pstrPassword		[in] Password string for pairing. String can include only 
        //				the numbers (0-9) characters.Value used only with CONAPI_PAIR_DEVICE 
        //				operation. With other operations value should be NULL.
        //	pstrName			[in] Reserved for future use, the value must be NULL.

        //
        // Return values:
        //	CONA_OK
        //	ECONA_INVALID_POINTER
        //	ECONA_INVALID_HANDLE
        //	ECONA_DEVICE_NOT_FOUND
        //	ECONA_NOT_SUPPORTED_DEVICE
        //	ECONA_CONNECTION_FAILED
        //	ECONA_CONNECTION_FAILED
        //	ECONA_CONNECTION_BUSY
        //	ECONA_CONNECTION_LOST
        //	ECONA_DEVICE_PAIRING_FAILED
        //	ECONA_DEVICE_ PASSWORD_WRONG
        //	ECONA_DEVICE_ PASSWORD_INVALID
        //	ECONA_FAILED_TIMEOUT
        //	ECONA_NO_CONNECTION_VIA_MEDIA
        //	ECONA_MEDIA_IS_NOT_WORKING
        //	ECONA_SUSPEND
        //	ECONA_NOT_ENOUGH_MEMORY
        //	ECONA_NOT_INITIALIZED
        //	ECONA_NOT_SUPPORTED_PC
        //	ECONA_UNKNOWN_ERROR
        public static extern int CONAChangeDeviceTrustedState(
            int hDMHandle,
            int dwTrustedOperation,
            [MarshalAs(UnmanagedType.LPWStr)] string pstrAddress,
            [MarshalAs(UnmanagedType.LPWStr)] string pstrPassword,
            [MarshalAs(UnmanagedType.LPWStr)] string pstrName
            );

        [DllImport("ConnAPI", CharSet = CharSet.Ansi, SetLastError = true, ExactSpelling = true)]
        //=========================================================
        //
        //=========================================================
        // CONAGetDeviceInfo
        //
        // Description:
        //	CONAGetDeviceInfo function sets the device specific information to the structure. 
        //  The structure type and allocation depends on which information is requested.
        //	The structure must be freed or clear by calling the CONAFreeDeviceInfoStructure function.
        //
        // Parameters:
        //	hDMHandle			[in]  Existing device management handle.
        //	pstrSerialNumber	[in]  Device's serial number.
        //	dwStructureType		[in]  Structure type value:
        //								CONAPI_DEVICE_GENERAL_INFO
        //								CONAPI_DEVICE_PRODUCT_INFO
        //								CONAPI_DEVICE_PROPERTIES_INFO
        //								CONAPI_DEVICE_ICON_INFO
        //	ppStructure			[out] Pointer to the information structure.
        //
        // 
        // Return values:
        // CONA_OK
        // ECONA_INVALID_POINTER
        // ECONA_INVALID_PARAMETER
        // ECONA_INVALID_HANDLE
        // ECONA_DEVICE_NOT_FOUND
        // ECONA_NOT_INITIALIZED
        // ECONA_NOT_SUPPORTED_DEVICE
        // ECONA_NOT_SUPPORTED_MANUFACTURER
        // ECONA_NOT_ENOUGH_MEMORY
        // ECONA_UNKNOWN_ERROR
        //
        //	PCCS_DMAPI CONAGetDeviceInfo(
        //						DMHANDLE	 hDMHandle, 
        //						const WCHAR* pstrSerialNumber, 
        //						DWORD		 dwStructureType,
        //						LPVOID*		 ppStructure
        //						);
        public static extern int CONAGetDeviceInfo(
            int hDMHandle,
            [MarshalAs(UnmanagedType.LPWStr)] string pstrSerialNumber,
            int dwStructureType,
            ref System.IntPtr ppDeviceInfo);

        [DllImport("ConnAPI", CharSet = CharSet.Ansi, SetLastError = true, ExactSpelling = true)]
        //========================================================= 
        //
        //=========================================================
        // CONAFreeDeviceInfoStructure
        //
        // Description:
        //  CONAFreeDeviceInfoStructure releases the (e.g.  
        //  CONAPI_DEVICE_GEN_INFO) structure that CONAGetDeviceInfo function has allocated.
        //
        // Parameters:
        //	dwStructureType	[in] Structure type value:
        //							CONAPI_DEVICE_GENERAL_INFO
        //							CONAPI_DEVICE_PRODUCT_INFO
        //							CONAPI_DEVICE_PROPERTIES_INFO
        //							CONAPI_DEVICE_ICON_INFO
        //	pStructure		[in] Pointer to the structure that the CONAGetDeviceInfo function has allocated
        //
        // Return values:
        //	CONA_OK
        //	ECONA_INVALID_POINTER
        //	ECONA_INVALID_PARAMETER
        //	ECONA_UNKNOWN_ERROR
        //
        //	PCCS_DMAPI CONAFreeDeviceInfoStructure( DWORD	dwStructureType, LPVOID	pStructure );
        //=========================================================
        public static extern int CONAFreeDeviceInfoStructure(int dwStructureType, System.IntPtr pDeviceInfo);
    }
}