using System;
using System.Linq;
using System.Runtime.InteropServices;
using System.Runtime.InteropServices.ComTypes;
using System.Security;
using System.Text;
using static Vanara.PInvoke.Ole32;
using BIND_OPTS = System.Runtime.InteropServices.ComTypes.BIND_OPTS;
namespace Vanara.PInvoke
{
public static partial class Shell32
{
/// Methods in this class will only work on Vista and above.
public static class ShellUtil
{
///
///
/// Represents flags that should be used when opening the file that contains the object identified by the moniker.
///
///
/// Indicates the amount of time (clock time in milliseconds) that the caller specified to complete the binding operation.
///
/// Flags that control aspects of moniker binding operations.
public static IBindCtx CreateBindCtx(STGM openMode = STGM.STGM_READWRITE, TimeSpan timeout = default, BIND_FLAGS bindFlags = 0)
{
Ole32.CreateBindCtx(0, out var ctx).ThrowIfFailed();
if (openMode != STGM.STGM_READWRITE || timeout != TimeSpan.Zero || bindFlags != 0)
{
var opts = new BIND_OPTS { cbStruct = Marshal.SizeOf(typeof(BIND_OPTS)), grfMode = (int)openMode, dwTickCountDeadline = (int)timeout.TotalMilliseconds, grfFlags = (int)bindFlags };
ctx.SetBindOptions(ref opts);
}
return ctx;
}
/// Gets the KNOWNFOLDERID enum from a KNOWNFOLDERID Guid.
/// The KNOWNFOLDERID Guid.
/// The KNOWNFOLDERID enum.
public static KNOWNFOLDERID GetKnownFolderFromGuid(Guid knownFolder) =>
Enum.GetValues(typeof(KNOWNFOLDERID)).Cast().Single(k => k.Guid() == knownFolder);
/// Gets the KNOWNFOLDERID enum from a path.
/// The folder path.
/// The KNOWNFOLDERID enum.
public static KNOWNFOLDERID GetKnownFolderFromPath(string path)
{
if (Environment.OSVersion.Version.Major < 6)
return Enum.GetValues(typeof(KNOWNFOLDERID)).Cast().Single(k => string.Equals(k.FullPath(), path, StringComparison.InvariantCultureIgnoreCase));
var ikfm = new IKnownFolderManager();
return GetKnownFolderFromGuid(ikfm.FindFolderFromPath(path, FFFP_MODE.FFFP_EXACTMATCH).GetId());
}
/// Gets the path for a KNOWNFOLDERID Guid.
/// The KNOWNFOLDERID Guid.
/// The file system path.
[SecurityCritical]
public static string GetPathForKnownFolder(Guid knownFolder)
{
if (knownFolder == default)
return null;
var pathBuilder = new StringBuilder(260);
if (SHGetFolderPathEx(knownFolder, 0, HTOKEN.NULL, pathBuilder, (uint)pathBuilder.Capacity).Failed)
return null;
return pathBuilder.ToString();
}
/// Gets the path from shell item.
/// The shell item.
/// The file system path.
[SecurityCritical]
public static string GetPathFromShellItem(IShellItem item) => item.GetDisplayName(SIGDN.SIGDN_DESKTOPABSOLUTEEDITING);
/// Gets the shell item for a file system path.
/// The file system path.
/// The corresponding IShellItem.
[SecurityCritical]
public static IShellItem GetShellItemForPath(string path)
{
if (string.IsNullOrEmpty(path))
return null;
// Handle case of a 'shell' URI and convert GUID to known folder
if (path.StartsWith("shell:::", StringComparison.InvariantCultureIgnoreCase))
{
path = path.Substring(8);
var separatorIndex = path.IndexOf('/');
var kf = new Guid(separatorIndex == -1 ? path : path.Substring(0, separatorIndex));
var fullPath = GetPathForKnownFolder(kf);
if (separatorIndex != -1)
fullPath += path.Substring(separatorIndex).Replace('/', '\\');
path = fullPath;
}
var hr = SHCreateItemFromParsingName(path, null, typeof(IShellItem).GUID, out var unk);
if (hr == (HRESULT)Win32Error.ERROR_FILE_NOT_FOUND)
{
using var ibc = InteropServices.ComReleaserFactory.Create(CreateBindCtx());
var bd = new IntFileSysBindData();
ibc.Item.RegisterObjectParam(STR_FILE_SYS_BIND_DATA, bd);
return SHCreateItemFromParsingName(path, ibc.Item);
}
hr.ThrowIfFailed();
return (IShellItem)unk;
}
/// Requests a specified interface from a COM object.
/// The interface to be queried.
/// The interface identifier (IID) of the requested interface.
/// The returned interface.
public static object QueryInterface(in object iUnk, in Guid riid)
{
QueryInterface(iUnk, riid, out var ppv).ThrowIfFailed();
return ppv;
}
/// Requests a specified interface from a COM object.
/// The interface to be queried.
/// The interface identifier (IID) of the requested interface.
/// When this method returns, contains the returned interface.
/// An HRESULT that indicates the success or failure of the call.
public static HRESULT QueryInterface(in object iUnk, in Guid riid, out object ppv)
{
var tmp = riid;
HRESULT hr = Marshal.QueryInterface(Marshal.GetIUnknownForObject(iUnk), ref tmp, out var ippv);
ppv = hr.Succeeded ? Marshal.GetObjectForIUnknown(ippv) : null;
System.Diagnostics.Debug.WriteLine($"Successful QI:\t{riid}");
return hr;
}
[ComVisible(true)]
private class IntFileSysBindData : IFileSystemBindData2
{
private static readonly Guid CLSID_UnknownJunction = new Guid("{fc0a77e6-9d70-4258-9783-6dab1d0fe31e}");
private Guid clsidJunction;
private WIN32_FIND_DATA fd;
private long fileId;
public IntFileSysBindData()
{
}
public HRESULT GetFileID(out long pliFileID) { pliFileID = fileId; return HRESULT.S_OK; }
public HRESULT GetFindData(out WIN32_FIND_DATA pfd) { pfd = fd; return HRESULT.S_OK; }
public HRESULT GetJunctionCLSID(out Guid pclsid)
{
if (clsidJunction != CLSID_UnknownJunction)
{
pclsid = clsidJunction;
return HRESULT.S_OK;
}
pclsid = Guid.Empty;
return HRESULT.E_FAIL;
}
public HRESULT SetFileID(long liFileID) { fileId = liFileID; return HRESULT.S_OK; }
public HRESULT SetFindData(in WIN32_FIND_DATA pfd) { fd = pfd; return HRESULT.S_OK; }
public HRESULT SetJunctionCLSID(in Guid clsid) { clsidJunction = clsid; return HRESULT.S_OK; }
}
}
}
}