Click here to Skip to main content
15,861,172 members
Articles / Desktop Programming / ATL
Article

Shell Extensions for .NET Assemblies

Rate me:
Please Sign up or sign in to vote.
4.98/5 (29 votes)
17 Nov 2005Ms-PL3 min read 183K   2.6K   81   41
Shell extensions to distinguish between .NET assemblies and Win32 applications and libraries.

About the Shell Extensions for .NET Assemblies

These shell extensions were written to help distinguish between .NET assemblies and Win32 libraries, as well as give extra information about the assemblies without having to drop to a command-prompt to use the SDK and CLR tools. These shell extensions function similar to the loader that makes both .NET and VB (pre-.NET) possible as executable code: the PE/COFF header. As such, the library is very fast and won't hinder your file system browsing experience. A recent update further enhances performance by skipping assembly detection on slow paths, such as UNC paths or drive mappings to remote filesystems via VPN.

Provided in this library are:

  1. Overlay icons for .NET assemblies (.dll)

    Overlay icon 

  2. Column handlers to show the public key token and specific type of .NET assemblies.

    Column handlers 

  3. Automation object for getting the above information in your own applications and libraries.

The Automation Object

Not only does this tool help you distinguish between .NET assemblies and Win32 applications and libraries, but it also provides you with a simple automation object that these shell extensions use.

To generate code from the type library, add a reference or #import the type library named "AsmShell 1.0 Type Library". Use the members of the IAssemblyInfo automation interface as follows:

  • IAssemblyInfo::IsAssembly([in]BSTR path, [out, retval]VARIANT_BOOL* retVal)
    Returns true if the specified file is an assembly, false if it is not, and raises errors when problems occur.
  • IAssemblyInfo::GetFileType([in]BSTR path, [out, retval]FileType* retVal)
    Returns a FileType enumeration member depending on the information for the specified file in the PE/COFF header.
  • IAssemblyInfo::GetPublicKeyToken([in]BSTR path, [out, retval]BSTR* retVal)
    Returns the public key token for the specified assembly.
  • IAssemblyInfo::GetPublicKey([in]BSTR path, [out, retval]SAFEARRAY(BYTE)* retVal)
    Returns the public key as a byte array for the specified assembly. This is not supported by JScript or VBScript, both of which only support an array of VARIANTs.

For each method, late-binding languages like Visual Basic will use the return value (marked with [out, retval]) as the return type of the method, also getting rid of the need for the parameter labeled with the specified attributes above.

So, in VB6 and .NET (C#, VB.NET, et. al.), the methods signatures would look like:

C#
bool IsAssembly(string path);
FileType GetFileType(string path);
string GetPublicKeyToken(string path);
byte[] GetPublicKey(string path);

Requirements

You may be required to reboot if files being installed are currently loaded. If you have Windows XP and the previous condition is false, no reboot should be necessary. If you're using Windows 98, ME, or 2000, you should either log off and back on or reboot your system if the overlay icon is not present; the column handlers should be ready immediately after the installation is finished.

Changes

  • November 17, 2005
    • Note: late article update for an earlier release
    • Added support to display x86 (and MSIL) for assemblies, as well as IA64 and x64
  • May 30, 2005
  • August 29, 2004
    • Added localizability
    • String caching for better performance
    • Support for .NET modules (.netmodule)
  • October 15, 2003
    • Added condition that files should not be parsed for slow paths (ex: VPN)
  • September 19, 2002
    • Initial release to the web on The Code Project

Disclaimer

THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR HIS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

License

This article, along with any associated source code and files, is licensed under The Microsoft Public License (Ms-PL)


Written By
Software Developer Microsoft
United States United States
Principal Software Engineer currently working on Azure SDKs at Microsoft. My opinions are my own. I work on a number of OSS projects for work and personally in numerous languages including C++, C#, JavaScript, Go, Rust, et. al. See a problem, fix a problem (or at least create an issue)!

Avid outdoor adventurer 🏔️❄️👞🚴‍♂️, husband, father.

Comments and Discussions

 
GeneralIcon Location Pin
Sameers Javed25-Sep-05 10:40
Sameers Javed25-Sep-05 10:40 
GeneralRe: Icon Location Pin
Heath Stewart25-Sep-05 14:54
protectorHeath Stewart25-Sep-05 14:54 
GeneralRe: Icon Location Pin
Sameers Javed26-Sep-05 0:21
Sameers Javed26-Sep-05 0:21 
AnswerRe: Icon Location Pin
Heath Stewart26-Sep-05 4:24
protectorHeath Stewart26-Sep-05 4:24 
GeneralRe: Icon Location Pin
Sameers Javed26-Sep-05 10:23
Sameers Javed26-Sep-05 10:23 
AnswerRe: Icon Location Pin
Heath Stewart26-Sep-05 11:15
protectorHeath Stewart26-Sep-05 11:15 
GeneralRe: Icon Location Pin
Sameers Javed26-Sep-05 11:19
Sameers Javed26-Sep-05 11:19 
AnswerRe: Icon Location Pin
Heath Stewart26-Sep-05 11:25
protectorHeath Stewart26-Sep-05 11:25 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.