Site Tools


Differences

This shows you the differences between two versions of the page.

Link to this comparison view

developer:sdksamples:pluginsearchorder [2015/09/14]
127.0.0.1 external edit
developer:sdksamples:pluginsearchorder [2016/02/12] (current)
sandy
Line 3: Line 3:
 > **Version:​** //Rhino 4.0// > **Version:​** //Rhino 4.0//
  
-=====Also See===== +Also see [[developer:​sdksamples:​loadlibraryex|Plug-in Loading.]]
-[[developer:​sdksamples:​loadlibraryex|Plug-in Loading]]+
  
 =====Overview===== =====Overview=====
-Rhino plug-ins are Windows Dynamic Link Libraries, or DLLs. As such, Rhino uses Windows to load your plug-in. Rhino attempts to load your plug-in, and any dependent DLLs, in the following manner:+Rhino plug-ins are Windows Dynamic Link Libraries ​(DLLs). As such, Rhino uses Windows to load your plug-in. Rhino attempts to load your plug-in, and any dependent DLLs, in the following manner:
  
   - Alternate Search Order - uses **LoadLibraryEx** with the LOAD_WITH_ALTERED_SEARCH_PATH flag.   - Alternate Search Order - uses **LoadLibraryEx** with the LOAD_WITH_ALTERED_SEARCH_PATH flag.
   - Standard Search Order - uses **LoadLibrary**.   - Standard Search Order - uses **LoadLibrary**.
  
-Note, starting ​with Windows XP, the dynamic-link library (DLL) search order used by the system depends on the setting of the **HKLM\System\CurrentControlSet\Control\Session Manager\SafeDllSearchMode** value.+**Note:** Starting ​with Windows XP, the dynamic-link library (DLL) search order used by the system depends on the setting of the **HKLM\System\CurrentControlSet\Control\Session Manager\SafeDllSearchMode** value.
  
   * Windows Server 2003:  The default value is 1.   * Windows Server 2003:  The default value is 1.
   * Windows XP:  The default value is 0.   * Windows XP:  The default value is 0.
  
-=====Alternate ​Search Order=====+=====Alternate ​search order=====
  
-The **LoadLibraryEx** function supports an alternate search order if the call specifies LOAD_WITH_ALTERED_SEARCH_PATH and the lpFileName parameter specifies a path. If **SafeDllSearchMode** is 1, the alternate search order is as follows:+The **LoadLibraryEx** function supports an alternate search order if the call specifies LOAD_WITH_ALTERED_SEARCH_PATH and the lpFileName parameter specifies a path. If **SafeDllSearchMode** is 1, the alternate search order is:
  
   - The directory specified by lpFileName.   - The directory specified by lpFileName.
Line 26: Line 25:
   - The Windows directory. Use the **GetWindowsDirectory** function to get the path of this directory.   - The Windows directory. Use the **GetWindowsDirectory** function to get the path of this directory.
   - The current directory.   - The current directory.
-  - The directories ​that are listed in the PATH environment variable.+  - The directories listed in the PATH environment variable.
  
-If **SafeDllSearchMode** is 0, the alternate search order is as follows:+If **SafeDllSearchMode** is 0, the alternate search order is:
  
   - The directory specified by lpFileName.   - The directory specified by lpFileName.
Line 35: Line 34:
   - The 16-bit system directory. There is no function that obtains the path of this directory, but it is searched.   - The 16-bit system directory. There is no function that obtains the path of this directory, but it is searched.
   - The Windows directory. Use the **GetWindowsDirectory** function to get the path of this directory.   - The Windows directory. Use the **GetWindowsDirectory** function to get the path of this directory.
-  - The directories ​that are listed in the PATH environment variable.+  - The directories listed in the PATH environment variable.
  
-=====Standard ​Search Order===== +=====Standard ​search order===== 
-If **SafeDllSearchMode** is 1, the search order is as follows:+If **SafeDllSearchMode** is 1, the search order is:
  
   - The directory from which the application loaded.   - The directory from which the application loaded.
Line 45: Line 44:
   - The Windows directory. Use the **GetWindowsDirectory** function to get the path of this directory.   - The Windows directory. Use the **GetWindowsDirectory** function to get the path of this directory.
   - The current directory.   - The current directory.
-  - The directories ​that are listed in the PATH environment variable.+  - The directories listed in the PATH environment variable.
  
-If **SafeDllSearchMode** is 0, the search order is as follows:+If **SafeDllSearchMode** is 0, the search order is:
  
   - The directory from which the application loaded.   - The directory from which the application loaded.
Line 54: Line 53:
   - The 16-bit system directory. There is no function that obtains the path of this directory, but it is searched.   - The 16-bit system directory. There is no function that obtains the path of this directory, but it is searched.
   - The Windows directory. Use the **GetWindowsDirectory** function to get the path of this directory.   - The Windows directory. Use the **GetWindowsDirectory** function to get the path of this directory.
-  - The directories ​that are listed in the PATH environment variable.+  - The directories listed in the PATH environment variable.
  
-Note, Windows 2000 does not support the **SafeDllSearchMode** value. The search order for Windows 2000 is as follows.+Windows 2000 does not support the **SafeDllSearchMode** value. The search order for Windows 2000 is:
  
   - The directory from which the application loaded.   - The directory from which the application loaded.
Line 63: Line 62:
   - The 16-bit system directory. There is no function that obtains the path of this directory, but it is searched.   - The 16-bit system directory. There is no function that obtains the path of this directory, but it is searched.
   - The Windows directory. Use the **GetWindowsDirectory** function to get the path of this directory.   - The Windows directory. Use the **GetWindowsDirectory** function to get the path of this directory.
-  - The directories ​that are listed in the PATH environment variable.+  - The directories listed in the PATH environment variable.
  
  
developer/sdksamples/pluginsearchorder.txt · Last modified: 2016/02/12 by sandy