FindResource (kernel32)
Last changed: -216.37.220.61

.
Summary
Determines the location of a resource with the specified type and name in the specified module.

C# Signatures:

[DllImport("kernel32.dll")]
static extern IntPtr FindResource(IntPtr hModule, IntPtr lpName, IntPtr lpType);

[DllImport( "kernel32.dll" )]
static extern IntPtr FindResource(IntPtr hModule, int lpName, int lpType);

[DllImport( "kernel32.dll" )]
static extern IntPtr FindResource(IntPtr hModule, int lpName, string lpType);

[DllImport( "kernel32.dll" )]
static extern IntPtr FindResource(IntPtr hModule, string lpName, int lpType);

[DllImport( "kernel32.dll", SetLastError=true )]
static extern IntPtr FindResource(IntPtr hModule, string lpName, string lpType);

VB.NET Signatures:

<DllImport("kernel32.dll")> _
Private Shared Function FindResource(hModule As IntPtr, lpName As IntPtr, lpType As IntPtr) As IntPtr
End Function

<DllImport("kernel32.dll")> _
Private Shared Function FindResource(hModule As IntPtr, lpName As Integer, lpType As Integer) As IntPtr
End Function

<DllImport("kernel32.dll")> _
Private Shared Function FindResource(hModule As IntPtr, lpName As Integer, lpType As String) As IntPtr
End Function

<DllImport("kernel32.dll")> _
Private Shared Function FindResource(hModule As IntPtr, lpName As String, lpType As Integer) As IntPtr
End Function

<DllImport("kernel32.dll", SetLastError := True)> _
Private Shared Function FindResource(hModule As IntPtr, lpName As String, lpType As String) As IntPtr
End Function

User-Defined Types:

None.

Notes:

The last 4 overrides are probably more useful than the first. They can be used without any casting.

if the function failes, you can call Marshal.GetLastWin32Error() to get the error code, and send it to the Win32Exception constructor to get the message.

Tips & Tricks:

Please add some!

Sample Code:

this code finds a resource in another executable, loads it to memory, and returns a pointer to it.

    private IntPtr FindLoadnLock(IntPtr hExe, String fileName, String fileType) {
      IntPtr hResource;  //handle to resource
      IntPtr pResource;  //pointer to resource in memory
      hResource = FindResource(hExe, fileName, fileType);
      if (hResource.ToInt32() == 0) {
    throw new Win32Exception(Marshal.GetLastWin32Error());
      }
      hResource = LoadResource(hExe, hResource);
      if (hResource.ToInt32() == 0) {
    throw new Win32Exception(Marshal.GetLastWin32Error());
      }
      pResource = LockResource(hResource);
      if (pResource.ToInt32() == 0) {
    throw new Win32Exception(Marshal.GetLastWin32Error());
      }
      return pResource;
    }

Alternative Managed API:

Do you know one? Please contribute it!

Documentation