|
// ------------------------------------------------------------------------------
// <auto-generated>
// This code was generated by a tool.
//
// Changes to this file may cause incorrect behavior and will be lost if
// the code is regenerated.
// </auto-generated>
// ------------------------------------------------------------------------------
#pragma warning disable CS1591,CS1573,CS0465,CS0649,CS8019,CS1570,CS1584,CS1658,CS0436,CS8981
using global::System;
using global::System.Diagnostics;
using global::System.Diagnostics.CodeAnalysis;
using global::System.Runtime.CompilerServices;
using global::System.Runtime.InteropServices;
using global::System.Runtime.Versioning;
using winmdroot = global::Windows.Win32;
namespace Windows.Win32
{
/// <content>
/// Contains extern methods from "SHELL32.dll".
/// </content>
internal static partial class PInvokeCore
{
/// <summary>Registers whether a window accepts dropped files.</summary>
/// <param name="hWnd">
/// <para>Type: <b>HWND</b> The identifier of the window that is registering whether it will accept dropped files.</para>
/// <para><see href="https://learn.microsoft.com/windows/win32/api/shellapi/nf-shellapi-dragacceptfiles#parameters">Read more on docs.microsoft.com</see>.</para>
/// </param>
/// <param name="fAccept">
/// <para>Type: <b>BOOL</b> A value that indicates if the window identified by the <i>hWnd</i> parameter accepts dropped files. This value is <b>TRUE</b> to accept dropped files or <b>FALSE</b> to discontinue accepting dropped files.</para>
/// <para><see href="https://learn.microsoft.com/windows/win32/api/shellapi/nf-shellapi-dragacceptfiles#parameters">Read more on docs.microsoft.com</see>.</para>
/// </param>
/// <remarks>An application that calls <b>DragAcceptFiles</b> with the <i>fAccept</i> parameter set to <b>TRUE</b> has identified itself as able to process the <a href="https://docs.microsoft.com/windows/desktop/shell/wm-dropfiles">WM_DROPFILES</a> message from File Manager.</remarks>
[DllImport("SHELL32.dll", ExactSpelling = true),DefaultDllImportSearchPaths(DllImportSearchPath.System32)]
[SupportedOSPlatform("windows5.1.2600")]
internal static extern void DragAcceptFiles(winmdroot.Foundation.HWND hWnd, winmdroot.Foundation.BOOL fAccept);
/// <summary>Retrieves the names of dropped files that result from a successful drag-and-drop operation. (Unicode)</summary>
/// <param name="hDrop">
/// <para>Type: <b>HDROP</b> Identifier of the structure that contains the file names of the dropped files.</para>
/// <para><see href="https://learn.microsoft.com/windows/win32/api/shellapi/nf-shellapi-dragqueryfilew#parameters">Read more on docs.microsoft.com</see>.</para>
/// </param>
/// <param name="iFile">
/// <para>Type: <b>UINT</b> Index of the file to query. If the value of this parameter is 0xFFFFFFFF, <b>DragQueryFile</b> returns a count of the files dropped. If the value of this parameter is between zero and the total number of files dropped, <b>DragQueryFile</b> copies the file name with the corresponding value to the buffer pointed to by the <i>lpszFile</i> parameter.</para>
/// <para><see href="https://learn.microsoft.com/windows/win32/api/shellapi/nf-shellapi-dragqueryfilew#parameters">Read more on docs.microsoft.com</see>.</para>
/// </param>
/// <param name="lpszFile">
/// <para>Type: <b>LPTSTR</b> The address of a buffer that receives the file name of a dropped file when the function returns. This file name is a null-terminated string. If this parameter is <b>NULL</b>, <b>DragQueryFile</b> returns the required size, in characters, of this buffer.</para>
/// <para><see href="https://learn.microsoft.com/windows/win32/api/shellapi/nf-shellapi-dragqueryfilew#parameters">Read more on docs.microsoft.com</see>.</para>
/// </param>
/// <param name="cch">
/// <para>Type: <b>UINT</b> The size, in characters, of the <i>lpszFile</i> buffer.</para>
/// <para><see href="https://learn.microsoft.com/windows/win32/api/shellapi/nf-shellapi-dragqueryfilew#parameters">Read more on docs.microsoft.com</see>.</para>
/// </param>
/// <returns>
/// <para>Type: <b>UINT</b> A nonzero value indicates a successful call. When the function copies a file name to the buffer, the return value is a count of the characters copied, not including the terminating null character. If the index value is 0xFFFFFFFF, the return value is a count of the dropped files. Note that the index variable itself returns unchanged, and therefore remains 0xFFFFFFFF. If the index value is between zero and the total number of dropped files, and the <i>lpszFile</i> buffer address is <b>NULL</b>, the return value is the required size, in characters, of the buffer, <i>not including</i> the terminating null character.</para>
/// </returns>
/// <remarks>
/// <para>> [!NOTE] > The shellapi.h header defines DragQueryFile as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see [Conventions for Function Prototypes](/windows/win32/intl/conventions-for-function-prototypes).</para>
/// <para><see href="https://learn.microsoft.com/windows/win32/api/shellapi/nf-shellapi-dragqueryfilew#">Read more on docs.microsoft.com</see>.</para>
/// </remarks>
[DllImport("SHELL32.dll", ExactSpelling = true, EntryPoint = "DragQueryFileW"),DefaultDllImportSearchPaths(DllImportSearchPath.System32)]
[SupportedOSPlatform("windows5.1.2600")]
internal static extern uint DragQueryFile(winmdroot.UI.Shell.HDROP hDrop, uint iFile, winmdroot.Foundation.PWSTR lpszFile, uint cch);
}
}
|