]> git.saurik.com Git - apple/mdnsresponder.git/blobdiff - Clients/ExplorerPlugin/ExplorerPlugin.cpp
mDNSResponder-214.3.2.tar.gz
[apple/mdnsresponder.git] / Clients / ExplorerPlugin / ExplorerPlugin.cpp
index 5de124db0c86d288a1325f826b44e7d3ea70cc7c..b83dac843a0a3856374f3efc54c2d757aaa1ded6 100644 (file)
@@ -1,28 +1,39 @@
-/*
+/* -*- Mode: C; tab-width: 4 -*-
+ *
  * Copyright (c) 2003-2004 Apple Computer, Inc. All rights reserved.
  *
  * Copyright (c) 2003-2004 Apple Computer, Inc. All rights reserved.
  *
- * @APPLE_LICENSE_HEADER_START@
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
  * 
  * 
- * This file contains Original Code and/or Modifications of Original Code
- * as defined in and that are subject to the Apple Public Source License
- * Version 2.0 (the 'License'). You may not use this file except in
- * compliance with the License. Please obtain a copy of the License at
- * http://www.opensource.apple.com/apsl/ and read it before using this
- * file.
+ *     http://www.apache.org/licenses/LICENSE-2.0
  * 
  * 
- * The Original Code and all software distributed under the License are
- * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
- * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
- * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
- * Please see the License for the specific language governing rights and
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
  * limitations under the License.
  * limitations under the License.
- * 
- * @APPLE_LICENSE_HEADER_END@
 
     Change History (most recent first):
     
 $Log: ExplorerPlugin.cpp,v $
 
     Change History (most recent first):
     
 $Log: ExplorerPlugin.cpp,v $
+Revision 1.10  2009/03/30 18:51:04  herscher
+<rdar://problem/5925472> Current Bonjour code does not compile on Windows
+<rdar://problem/5187308> Move build train to Visual Studio 2005
+
+Revision 1.9  2006/08/14 23:24:00  cheshire
+Re-licensed mDNSResponder daemon source code under Apache License, Version 2.0
+
+Revision 1.8  2005/06/30 18:01:54  shersche
+<rdar://problem/4130635> Cause IE to rebuild cache so we don't have to reboot following an install.
+
+Revision 1.7  2005/02/23 02:00:45  shersche
+<rdar://problem/4014479> Delete all the registry entries when component is unregistered
+
+Revision 1.6  2005/01/25 17:56:45  shersche
+<rdar://problem/3911084> Load resource DLLs, get icons and bitmaps from resource DLLs
+Bug #: 3911084
+
 Revision 1.5  2004/09/15 10:33:54  shersche
 <rdar://problem/3721611> Install XP toolbar button (8 bit mask) if running on XP platform, otherwise install 1 bit mask toolbar button
 Bug #: 3721611
 Revision 1.5  2004/09/15 10:33:54  shersche
 <rdar://problem/3721611> Install XP toolbar button (8 bit mask) if running on XP platform, otherwise install 1 bit mask toolbar button
 Bug #: 3721611
@@ -65,6 +76,8 @@ Explorer Plugin to browse for DNS-SD advertised Web and FTP servers from within
 #include       "ClassFactory.h"
 #include       "Resource.h"
 
 #include       "ClassFactory.h"
 #include       "Resource.h"
 
+#include       "loclibrary.h"
+
 // MFC Debugging
 
 #ifdef _DEBUG
 // MFC Debugging
 
 #ifdef _DEBUG
@@ -81,20 +94,38 @@ static char THIS_FILE[] = __FILE__;
 //     Prototypes
 //===========================================================================================================================
 
 //     Prototypes
 //===========================================================================================================================
 
-// DLL Exports
+// Utilities
 
 
-extern "C" BOOL WINAPI DllMain( HINSTANCE inInstance, DWORD inReason, LPVOID inReserved );
+DEBUG_LOCAL OSStatus   RegisterServer( HINSTANCE inInstance, CLSID inCLSID, LPCTSTR inName );
+DEBUG_LOCAL OSStatus   RegisterCOMCategory( CLSID inCLSID, CATID inCategoryID, BOOL inRegister );
+DEBUG_LOCAL OSStatus   UnregisterServer( CLSID inCLSID );
+DEBUG_LOCAL OSStatus   MyRegDeleteKey( HKEY hKeyRoot, LPTSTR lpSubKey );
 
 
-// MFC Support
+// Stash away pointers to our resource DLLs
 
 
-DEBUG_LOCAL OSStatus   MFCDLLProcessAttach( HINSTANCE inInstance );
-DEBUG_LOCAL void               MFCDLLProcessDetach( HINSTANCE inInstance );
-DEBUG_LOCAL void               MFCDLLThreadDetach( HINSTANCE inInstance );
+static HINSTANCE g_nonLocalizedResources       = NULL;
+static CString  g_nonLocalizedResourcesName;
+static HINSTANCE g_localizedResources          = NULL;
 
 
-// Utilities
+HINSTANCE
+GetNonLocalizedResources()
+{
+       return g_nonLocalizedResources;
+}
+
+HINSTANCE
+GetLocalizedResources()
+{
+       return g_localizedResources;
+}
+
+// This is the class GUID for an undocumented hook into IE that will allow us to register
+// and have IE notice our new ExplorerBar without rebooting.
+// {8C7461EF-2B13-11d2-BE35-3078302C2030}
+
+DEFINE_GUID(CLSID_CompCatCacheDaemon, 
+0x8C7461EF, 0x2b13, 0x11d2, 0xbe, 0x35, 0x30, 0x78, 0x30, 0x2c, 0x20, 0x30);
 
 
-DEBUG_LOCAL OSStatus   RegisterServer( HINSTANCE inInstance, CLSID inCLSID, LPCTSTR inName );
-DEBUG_LOCAL OSStatus   RegisterCOMCategory( CLSID inCLSID, CATID inCategoryID, BOOL inRegister );
 
 #if 0
 #pragma mark == Globals ==
 
 #if 0
 #pragma mark == Globals ==
@@ -104,9 +135,9 @@ DEBUG_LOCAL OSStatus        RegisterCOMCategory( CLSID inCLSID, CATID inCategoryID, BOO
 //     Globals
 //===========================================================================================================================
 
 //     Globals
 //===========================================================================================================================
 
-HINSTANCE              gInstance               = NULL;
-int                            gDLLRefCount    = 0;
-CWinApp                        gApp;
+HINSTANCE                      gInstance               = NULL;
+int                                    gDLLRefCount    = 0;
+CExplorerPluginApp     gApp;
 
 #if 0
 #pragma mark -
 
 #if 0
 #pragma mark -
@@ -114,53 +145,83 @@ CWinApp                   gApp;
 #endif
 
 //===========================================================================================================================
 #endif
 
 //===========================================================================================================================
-//     DllMain
+//     CExplorerPluginApp::CExplorerPluginApp
 //===========================================================================================================================
 
 //===========================================================================================================================
 
-BOOL WINAPI    DllMain( HINSTANCE inInstance, DWORD inReason, LPVOID inReserved )
+IMPLEMENT_DYNAMIC(CExplorerPluginApp, CWinApp);
+
+CExplorerPluginApp::CExplorerPluginApp()
 {
 {
-       BOOL                    ok;
-       OSStatus                err;
-       
-       DEBUG_UNUSED( inReserved );
-       
-       ok = TRUE;
-       switch( inReason )
-       {
-               case DLL_PROCESS_ATTACH:
-                       gInstance = inInstance;
-                       debug_initialize( kDebugOutputTypeWindowsEventLog, "DNSServices Bar", inInstance );
-                       debug_set_property( kDebugPropertyTagPrintLevel, kDebugLevelTrace );
-                       dlog( kDebugLevelTrace, "\nDllMain: process attach\n" );
-                       
-                       err = MFCDLLProcessAttach( inInstance );
-                       ok = ( err == kNoErr );
-                       require_noerr( err, exit );
-                       break;
-               
-               case DLL_PROCESS_DETACH:
-                       dlog( kDebugLevelTrace, "DllMain: process detach\n" );
-                       MFCDLLProcessDetach( inInstance );
-                       break;
-               
-               case DLL_THREAD_ATTACH:
-                       dlog( kDebugLevelTrace, "DllMain: thread attach\n" );
-                       break;
-               
-               case DLL_THREAD_DETACH:
-                       dlog( kDebugLevelTrace, "DllMain: thread detach\n" );
-                       MFCDLLThreadDetach( inInstance );
-                       break;
-               
-               default:
-                       dlog( kDebugLevelTrace, "DllMain: unknown reason code (%d)\n",inReason );
-                       break;
-       }
-       
+}
+
+
+//===========================================================================================================================
+//     CExplorerPluginApp::~CExplorerPluginApp
+//===========================================================================================================================
+
+CExplorerPluginApp::~CExplorerPluginApp()
+{
+}
+
+
+//===========================================================================================================================
+//     CExplorerPluginApp::InitInstance
+//===========================================================================================================================
+
+BOOL
+CExplorerPluginApp::InitInstance()
+{
+       wchar_t                                 resource[MAX_PATH];
+       OSStatus                                err;
+       int                                             res;
+       HINSTANCE inInstance;
+
+       inInstance = AfxGetInstanceHandle();
+       gInstance = inInstance;
+
+       debug_initialize( kDebugOutputTypeWindowsEventLog, "DNSServices Bar", inInstance );
+       debug_set_property( kDebugPropertyTagPrintLevel, kDebugLevelTrace );
+       dlog( kDebugLevelTrace, "\nCCPApp::InitInstance\n" );
+
+       res = PathForResource( inInstance, L"ExplorerPluginResources.dll", resource, MAX_PATH );
+
+       err = translate_errno( res != 0, kUnknownErr, kUnknownErr );
+       require_noerr( err, exit );
+
+       g_nonLocalizedResources = LoadLibrary( resource );
+       translate_errno( g_nonLocalizedResources, GetLastError(), kUnknownErr );
+       require_noerr( err, exit );
+
+       g_nonLocalizedResourcesName = resource;
+
+       res = PathForResource( inInstance, L"ExplorerPluginLocalized.dll", resource, MAX_PATH );
+       err = translate_errno( res != 0, kUnknownErr, kUnknownErr );
+       require_noerr( err, exit );
+
+       g_localizedResources = LoadLibrary( resource );
+       translate_errno( g_localizedResources, GetLastError(), kUnknownErr );
+       require_noerr( err, exit );
+
+       AfxSetResourceHandle( g_localizedResources );
+
 exit:
 exit:
-       return( ok );
+
+       return TRUE;
 }
 
 }
 
+
+//===========================================================================================================================
+//     CExplorerPluginApp::ExitInstance
+//===========================================================================================================================
+
+int
+CExplorerPluginApp::ExitInstance()
+{
+       return 0;
+}
+
+
+
 //===========================================================================================================================
 //     DllCanUnloadNow
 //===========================================================================================================================
 //===========================================================================================================================
 //     DllCanUnloadNow
 //===========================================================================================================================
@@ -219,9 +280,10 @@ exit:
 
 STDAPI DllRegisterServer( void )
 {
 
 STDAPI DllRegisterServer( void )
 {
-       HRESULT         err;
-       BOOL            ok;
-       CString         s;
+       IRunnableTask * pTask = NULL;
+       HRESULT                 err;
+       BOOL                    ok;
+       CString                 s;
        
        dlog( kDebugLevelTrace, "DllRegisterServer\n" );
        
        
        dlog( kDebugLevelTrace, "DllRegisterServer\n" );
        
@@ -233,7 +295,16 @@ STDAPI     DllRegisterServer( void )
        
        err = RegisterCOMCategory( CLSID_ExplorerBar, CATID_InfoBand, TRUE );
        require_noerr( err, exit );
        
        err = RegisterCOMCategory( CLSID_ExplorerBar, CATID_InfoBand, TRUE );
        require_noerr( err, exit );
-       
+
+       // <rdar://problem/4130635> Clear IE cache so it will rebuild the cache when it runs next.  This
+       // will allow us to install and not reboot
+
+       err = CoCreateInstance(CLSID_CompCatCacheDaemon, NULL, CLSCTX_INPROC, IID_IRunnableTask, (void**) &pTask);
+       require_noerr( err, exit );
+
+       pTask->Run();
+       pTask->Release();
+
 exit:
        return( err );
 }
 exit:
        return( err );
 }
@@ -250,117 +321,14 @@ STDAPI   DllUnregisterServer( void )
        
        err = RegisterCOMCategory( CLSID_ExplorerBar, CATID_InfoBand, FALSE );
        require_noerr( err, exit );
        
        err = RegisterCOMCategory( CLSID_ExplorerBar, CATID_InfoBand, FALSE );
        require_noerr( err, exit );
-       
-exit:
-       return( err );
-}
 
 
-#if 0
-#pragma mark -
-#pragma mark == MFC Support ==
-#endif
-
-//===========================================================================================================================
-//     MFCDLLProcessAttach
-//===========================================================================================================================
-
-DEBUG_LOCAL OSStatus   MFCDLLProcessAttach( HINSTANCE inInstance )
-{
-       OSStatus                                err;
-       _AFX_THREAD_STATE *             threadState;
-       AFX_MODULE_STATE *              previousModuleState;
-       BOOL                                    ok;
-       CWinApp *                               app;
-       
-       app = NULL;
-       
-       // Simulate what is done in dllmodul.cpp.
-       
-       threadState = AfxGetThreadState();
-       check( threadState );
-       previousModuleState = threadState->m_pPrevModuleState;
-       
-       ok = AfxWinInit( inInstance, NULL, TEXT( "" ), 0 );
-       require_action( ok, exit, err = kUnknownErr );
-       
-       app = AfxGetApp();
-       require_action( ok, exit, err = kNotInitializedErr );
-       
-       ok = app->InitInstance();
-       require_action( ok, exit, err = kUnknownErr );
-       
-       threadState->m_pPrevModuleState = previousModuleState;
-       threadState = NULL;
-       AfxInitLocalData( inInstance );
-       err = kNoErr;
+       err = UnregisterServer( CLSID_ExplorerBar );
+       require_noerr( err, exit );
        
 exit:
        
 exit:
-       if( err )
-       {
-               if( app )
-               {
-                       app->ExitInstance();
-               }
-               AfxWinTerm();
-       }
-       if( threadState )
-       {
-               threadState->m_pPrevModuleState = previousModuleState;
-       }
        return( err );
 }
 
        return( err );
 }
 
-//===========================================================================================================================
-//     MFCDLLProcessDetach
-//===========================================================================================================================
-
-DEBUG_LOCAL void       MFCDLLProcessDetach( HINSTANCE inInstance )
-{
-       CWinApp *               app;
-
-       // Simulate what is done in dllmodul.cpp.
-       
-       app = AfxGetApp();
-       if( app )
-       {
-               app->ExitInstance();
-       }
-
-#if( DEBUG )
-       if( AfxGetModuleThreadState()->m_nTempMapLock != 0 )
-       {
-               dlog( kDebugLevelWarning, "Warning: Temp map lock count non-zero (%ld).\n", AfxGetModuleThreadState()->m_nTempMapLock );
-       }
-#endif
-       
-       AfxLockTempMaps();
-       AfxUnlockTempMaps( -1 );
-
-       // Terminate the library before destructors are called.
-       
-       AfxWinTerm();
-       AfxTermLocalData( inInstance, TRUE );
-}
-
-//===========================================================================================================================
-//     MFCDLLFinalize
-//===========================================================================================================================
-
-DEBUG_LOCAL void       MFCDLLThreadDetach( HINSTANCE inInstance )
-{
-       // Simulate what is done in dllmodul.cpp.
-       
-#if( DEBUG )
-       if( AfxGetModuleThreadState()->m_nTempMapLock != 0 )
-       {
-               dlog( kDebugLevelWarning, "Warning: Temp map lock count non-zero (%ld).\n", AfxGetModuleThreadState()->m_nTempMapLock );
-       }
-#endif
-       
-       AfxLockTempMaps();
-       AfxUnlockTempMaps( -1 );
-       AfxTermThread( inInstance );
-}
 
 #if 0
 #pragma mark -
 
 #if 0
 #pragma mark -
@@ -478,21 +446,21 @@ DEBUG_LOCAL OSStatus      RegisterServer( HINSTANCE inInstance, CLSID inCLSID, LPCTST
                 ( versionInfo.dwMajorVersion == 5 ) &&
             ( versionInfo.dwMinorVersion >= 1 ) )
        {
                 ( versionInfo.dwMajorVersion == 5 ) &&
             ( versionInfo.dwMinorVersion >= 1 ) )
        {
-               wsprintf( data, L"%s,%d", moduleName, IDI_BUTTON_XP );
+               wsprintf( data, L"%s,%d", (LPCTSTR) g_nonLocalizedResourcesName, IDI_BUTTON_XP );
                size = (DWORD)( ( lstrlen( data ) + 1 ) * sizeof( TCHAR ) );
                RegSetValueEx( key, L"Icon", 0, REG_SZ, (LPBYTE) data, size);
 
                size = (DWORD)( ( lstrlen( data ) + 1 ) * sizeof( TCHAR ) );
                RegSetValueEx( key, L"Icon", 0, REG_SZ, (LPBYTE) data, size);
 
-               wsprintf( data, L"%s,%d", moduleName, IDI_BUTTON_XP );
+               wsprintf( data, L"%s,%d", (LPCTSTR) g_nonLocalizedResourcesName, IDI_BUTTON_XP );
                size = (DWORD)( ( lstrlen( data ) + 1 ) * sizeof( TCHAR ) );
                RegSetValueEx( key, L"HotIcon", 0, REG_SZ, (LPBYTE) data, size);
        }
        else
        {
                size = (DWORD)( ( lstrlen( data ) + 1 ) * sizeof( TCHAR ) );
                RegSetValueEx( key, L"HotIcon", 0, REG_SZ, (LPBYTE) data, size);
        }
        else
        {
-               wsprintf( data, L"%s,%d", moduleName, IDI_BUTTON_2K );
+               wsprintf( data, L"%s,%d", (LPCTSTR) g_nonLocalizedResourcesName, IDI_BUTTON_2K );
                size = (DWORD)( ( lstrlen( data ) + 1 ) * sizeof( TCHAR ) );
                RegSetValueEx( key, L"Icon", 0, REG_SZ, (LPBYTE) data, size);
 
                size = (DWORD)( ( lstrlen( data ) + 1 ) * sizeof( TCHAR ) );
                RegSetValueEx( key, L"Icon", 0, REG_SZ, (LPBYTE) data, size);
 
-               wsprintf( data, L"%s,%d", moduleName, IDI_BUTTON_2K );
+               wsprintf( data, L"%s,%d", (LPCTSTR) g_nonLocalizedResourcesName, IDI_BUTTON_2K );
                size = (DWORD)( ( lstrlen( data ) + 1 ) * sizeof( TCHAR ) );
                RegSetValueEx( key, L"HotIcon", 0, REG_SZ, (LPBYTE) data, size);
        }
                size = (DWORD)( ( lstrlen( data ) + 1 ) * sizeof( TCHAR ) );
                RegSetValueEx( key, L"HotIcon", 0, REG_SZ, (LPBYTE) data, size);
        }
@@ -536,3 +504,138 @@ DEBUG_LOCAL OSStatus      RegisterCOMCategory( CLSID inCLSID, CATID inCategoryID, BOO
 exit:
        return( err );
 }
 exit:
        return( err );
 }
+
+
+//===========================================================================================================================
+//     UnregisterServer
+//===========================================================================================================================
+
+DEBUG_LOCAL OSStatus   UnregisterServer( CLSID inCLSID )
+{
+       OSStatus                        err = 0;
+       LPWSTR                          clsidWideString;
+       TCHAR                           clsidString[ 64 ];
+       HKEY                            key;
+       TCHAR                           keyName[ MAX_PATH * 2 ];
+       OSVERSIONINFO           versionInfo;
+
+       // Convert the CLSID to a string based on the encoding of this code (ANSI or Unicode).
+       
+       err = StringFromIID( inCLSID, &clsidWideString );
+       require_noerr( err, exit );
+       require_action( clsidWideString, exit, err = kNoMemoryErr );
+       
+       #ifdef UNICODE
+               lstrcpyn( clsidString, clsidWideString, sizeof_array( clsidString ) );
+               CoTaskMemFree( clsidWideString );
+       #else
+               nChars = WideCharToMultiByte( CP_ACP, 0, clsidWideString, -1, clsidString, sizeof_array( clsidString ), NULL, NULL );
+               err = translate_errno( nChars > 0, (OSStatus) GetLastError(), kUnknownErr );
+               CoTaskMemFree( clsidWideString );
+               require_noerr( err, exit );
+       #endif
+
+       wsprintf( keyName, L"CLSID\\%s", clsidString );
+       MyRegDeleteKey( HKEY_CLASSES_ROOT, keyName );
+       
+       // If running on NT, de-register the extension as approved.
+       
+       versionInfo.dwOSVersionInfoSize = sizeof( versionInfo );
+       GetVersionEx( &versionInfo );
+       if( versionInfo.dwPlatformId == VER_PLATFORM_WIN32_NT )
+       {
+               lstrcpyn( keyName, TEXT( "SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Shell Extensions\\Approved" ), sizeof_array( keyName ) );
+               err = RegCreateKeyEx( HKEY_LOCAL_MACHINE, keyName, 0, NULL, REG_OPTION_NON_VOLATILE, KEY_WRITE, NULL, &key, NULL );
+               require_noerr( err, exit );
+
+               RegDeleteValue( key, clsidString );
+
+               err = RegCloseKey( key );
+               require_noerr( err, exit );
+       }
+
+       // de-register toolbar button
+
+       lstrcpyn( keyName, TEXT( "SOFTWARE\\Microsoft\\Internet Explorer\\Extensions\\{7F9DB11C-E358-4ca6-A83D-ACC663939424}"), sizeof_array( keyName ) );
+       MyRegDeleteKey( HKEY_LOCAL_MACHINE, keyName );
+       
+exit:
+       return( err );
+}
+
+
+
+//===========================================================================================================================
+//     MyRegDeleteKey
+//===========================================================================================================================
+
+DEBUG_LOCAL OSStatus MyRegDeleteKey( HKEY hKeyRoot, LPTSTR lpSubKey )
+{
+    LPTSTR lpEnd;
+    OSStatus err;
+    DWORD dwSize;
+    TCHAR szName[MAX_PATH];
+    HKEY hKey;
+    FILETIME ftWrite;
+
+    // First, see if we can delete the key without having to recurse.
+
+    err = RegDeleteKey( hKeyRoot, lpSubKey );
+
+    if ( !err )
+       {
+               goto exit;
+       }
+
+    err = RegOpenKeyEx( hKeyRoot, lpSubKey, 0, KEY_READ, &hKey );
+       require_noerr( err, exit );
+
+    // Check for an ending slash and add one if it is missing.
+
+    lpEnd = lpSubKey + lstrlen(lpSubKey);
+
+    if ( *( lpEnd - 1 ) != TEXT( '\\' ) ) 
+    {
+        *lpEnd =  TEXT('\\');
+        lpEnd++;
+        *lpEnd =  TEXT('\0');
+    }
+
+    // Enumerate the keys
+
+    dwSize = MAX_PATH;
+    err = RegEnumKeyEx(hKey, 0, szName, &dwSize, NULL, NULL, NULL, &ftWrite);
+
+    if ( !err ) 
+    {
+        do
+               {
+            lstrcpy (lpEnd, szName);
+
+            if ( !MyRegDeleteKey( hKeyRoot, lpSubKey ) )
+                       {
+                break;
+            }
+
+            dwSize = MAX_PATH;
+
+            err = RegEnumKeyEx( hKey, 0, szName, &dwSize, NULL, NULL, NULL, &ftWrite );
+
+        }
+               while ( !err );
+    }
+
+    lpEnd--;
+    *lpEnd = TEXT('\0');
+
+    RegCloseKey( hKey );
+
+    // Try again to delete the key.
+
+    err = RegDeleteKey(hKeyRoot, lpSubKey);
+       require_noerr( err, exit );
+
+exit:
+
+       return err;
+}