sean-m
/
Vanara
mirror of https://github.com/dahall/Vanara.git
1
0
Fork 0
Code Issues Releases Wiki Activity

Finished nullable work on SearchApi

nullableenabled
David Hall 2023-08-04 18:05:44 -06:00
parent 1aba884b1e
commit bdb62a47da
6 changed files with 158 additions and 92 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
PInvoke/Ole/Ole32/ObjIdl3.cs
View File

@ -629,6 +629,15 @@ public static partial class Ole32
/// <returns>The enumerated values.</returns> /// <returns>The enumerated values.</returns>
public static IEnumerable<T?> Enumerate<T>(this IEnumUnknown e) where T : class => e.Enumerate().Select(p => p == IntPtr.Zero ? null : (T)Marshal.GetObjectForIUnknown(p)); public static IEnumerable<T?> Enumerate<T>(this IEnumUnknown e) where T : class => e.Enumerate().Select(p => p == IntPtr.Zero ? null : (T)Marshal.GetObjectForIUnknown(p));
/// <summary>Enumerates the values in a <see cref="IEnumUnknown"/> instance.</summary>
/// <typeparam name="T">
/// The COM interface type to query for from each item in the collection. Note that if this type cannot be retrieved, an exception
/// will be thrown.
/// </typeparam>
/// <param name="e">The <see cref="IEnumUnknown"/> instance.</param>
/// <returns>The enumerated values.</returns>
public static IEnumerable<T> EnumerateNonNulls<T>(this IEnumUnknown e) where T : class => e.Enumerate<T>().Where(i => i is not null).Cast<T>();
/// <summary>Structure returned by IEnumContextProps::Enum</summary> /// <summary>Structure returned by IEnumContextProps::Enum</summary>
[PInvokeData("objidl.h", MSDNShortId = "64591e45-5478-4360-8c1f-08b09b5aef8e")] [PInvokeData("objidl.h", MSDNShortId = "64591e45-5478-4360-8c1f-08b09b5aef8e")]
// https://docs.microsoft.com/en-us/windows/desktop/api/objidl/nf-objidl-ienumcontextprops-next // https://docs.microsoft.com/en-us/windows/desktop/api/objidl/nf-objidl-ienumcontextprops-next

16
PInvoke/SearchApi/SearchApi.cs
View File

@ -964,7 +964,7 @@ public static partial class SearchApi
// *SearchDecSize, WCHAR **pwcsSearchDesc, IFilter **ppIFilt ); // *SearchDecSize, WCHAR **pwcsSearchDesc, IFilter **ppIFilt );
[PInvokeData("filtereg.h", MSDNShortId = "b4eff132-9022-4091-a2a3-1d8e11a35b39")] [PInvokeData("filtereg.h", MSDNShortId = "b4eff132-9022-4091-a2a3-1d8e11a35b39")]
[Obsolete, PreserveSig] [Obsolete, PreserveSig]
HRESULT LoadIFilterFromStorage([In] IStorage pStg, [In, MarshalAs(UnmanagedType.IUnknown)] object pUnkOuter, [In, MarshalAs(UnmanagedType.LPWStr)] string pwcsOverride, HRESULT LoadIFilterFromStorage([In] IStorage pStg, [In, MarshalAs(UnmanagedType.IUnknown)] object? pUnkOuter, [In, MarshalAs(UnmanagedType.LPWStr)] string pwcsOverride,
[In, MarshalAs(UnmanagedType.Bool)] bool fUseDefault, out Guid pFilterClsid, [Optional] IntPtr SearchDecSize, [Optional] IntPtr pwcsSearchDesc, out IFilter ppIFilt); [In, MarshalAs(UnmanagedType.Bool)] bool fUseDefault, out Guid pFilterClsid, [Optional] IntPtr SearchDecSize, [Optional] IntPtr pwcsSearchDesc, out IFilter ppIFilt);
/// <summary> /// <summary>
@ -985,7 +985,7 @@ public static partial class SearchApi
// *pFilterClsid, int *SearchDecSize, WCHAR **pwcsSearchDesc, IFilter **ppIFilt ); // *pFilterClsid, int *SearchDecSize, WCHAR **pwcsSearchDesc, IFilter **ppIFilt );
[PInvokeData("filtereg.h", MSDNShortId = "6a577306-d5ff-43c1-ab9f-3a7437661d2a")] [PInvokeData("filtereg.h", MSDNShortId = "6a577306-d5ff-43c1-ab9f-3a7437661d2a")]
[Obsolete, PreserveSig] [Obsolete, PreserveSig]
HRESULT LoadIFilterFromStream([In] IStream pStm, in FILTERED_DATA_SOURCES pFilteredSources, [In, MarshalAs(UnmanagedType.IUnknown)] object pUnkOuter, HRESULT LoadIFilterFromStream([In] IStream pStm, in FILTERED_DATA_SOURCES pFilteredSources, [In, MarshalAs(UnmanagedType.IUnknown)] object? pUnkOuter,
[In, MarshalAs(UnmanagedType.Bool)] bool fUseDefault, out Guid pFilterClsid, [Optional] IntPtr SearchDecSize, [Optional] IntPtr pwcsSearchDesc, out IFilter ppIFilt); [In, MarshalAs(UnmanagedType.Bool)] bool fUseDefault, out Guid pFilterClsid, [Optional] IntPtr SearchDecSize, [Optional] IntPtr pwcsSearchDesc, out IFilter ppIFilt);
} }
@ -2096,7 +2096,7 @@ public static partial class SearchApi
// EnumerateRoots( IEnumSearchRoots **ppSearchRoots ); // EnumerateRoots( IEnumSearchRoots **ppSearchRoots );
[PInvokeData("searchapi.h")] [PInvokeData("searchapi.h")]
[PreserveSig] [PreserveSig]
HRESULT EnumerateRoots(out IEnumSearchRoots ppSearchRoots); HRESULT EnumerateRoots(out IEnumSearchRoots? ppSearchRoots);
/// <summary>Adds a hierarchical scope to the search engine.</summary> /// <summary>Adds a hierarchical scope to the search engine.</summary>
/// <param name="pszURL"> /// <param name="pszURL">
@ -2472,7 +2472,7 @@ public static partial class SearchApi
// EnumerateRoots( IEnumSearchRoots **ppSearchRoots ); // EnumerateRoots( IEnumSearchRoots **ppSearchRoots );
[PInvokeData("searchapi.h")] [PInvokeData("searchapi.h")]
[PreserveSig] [PreserveSig]
new HRESULT EnumerateRoots(out IEnumSearchRoots ppSearchRoots); new HRESULT EnumerateRoots(out IEnumSearchRoots? ppSearchRoots);
/// <summary>Adds a hierarchical scope to the search engine.</summary> /// <summary>Adds a hierarchical scope to the search engine.</summary>
/// <param name="pszURL"> /// <param name="pszURL">
@ -4172,7 +4172,7 @@ public static partial class SearchApi
// HRESULT put_QueryContentProperties( LPCWSTR pszContentProperties ); // HRESULT put_QueryContentProperties( LPCWSTR pszContentProperties );
[PInvokeData("searchapi.h")] [PInvokeData("searchapi.h")]
[DispId(0x60010009)] [DispId(0x60010009)]
string QueryContentProperties { [param: In, MarshalAs(UnmanagedType.LPWStr)] set; [return: MarshalAs(UnmanagedType.LPWStr)] get; } string? QueryContentProperties { [param: In, MarshalAs(UnmanagedType.LPWStr)] set; [return: MarshalAs(UnmanagedType.LPWStr)] get; }
/// <summary>Gets or sets the columns (or properties) requested in the select statement.</summary> /// <summary>Gets or sets the columns (or properties) requested in the select statement.</summary>
/// <value> /// <value>
@ -6008,7 +6008,7 @@ public static partial class SearchApi
// *SearchDecSize, WCHAR **pwcsSearchDesc, IFilter **ppIFilt ); // *SearchDecSize, WCHAR **pwcsSearchDesc, IFilter **ppIFilt );
[PInvokeData("filtereg.h", MSDNShortId = "920c976e-4dde-4e53-85b7-7547291736a0")] [PInvokeData("filtereg.h", MSDNShortId = "920c976e-4dde-4e53-85b7-7547291736a0")]
[PreserveSig] [PreserveSig]
new HRESULT LoadIFilter([In, Optional, MarshalAs(UnmanagedType.LPWStr)] string? pwcsPath, in FILTERED_DATA_SOURCES pFilteredSources, [In, MarshalAs(UnmanagedType.IUnknown)] object pUnkOuter, new HRESULT LoadIFilter([In, Optional, MarshalAs(UnmanagedType.LPWStr)] string? pwcsPath, in FILTERED_DATA_SOURCES pFilteredSources, [In, MarshalAs(UnmanagedType.IUnknown)] object? pUnkOuter,
[In, MarshalAs(UnmanagedType.Bool)] bool fUseDefault, out Guid pFilterClsid, [Optional] IntPtr SearchDecSize, [Optional] IntPtr pwcsSearchDesc, out IFilter ppIFilt); [In, MarshalAs(UnmanagedType.Bool)] bool fUseDefault, out Guid pFilterClsid, [Optional] IntPtr SearchDecSize, [Optional] IntPtr pwcsSearchDesc, out IFilter ppIFilt);
/// <summary> /// <summary>
@ -6029,7 +6029,7 @@ public static partial class SearchApi
// *SearchDecSize, WCHAR **pwcsSearchDesc, IFilter **ppIFilt ); // *SearchDecSize, WCHAR **pwcsSearchDesc, IFilter **ppIFilt );
[PInvokeData("filtereg.h", MSDNShortId = "b4eff132-9022-4091-a2a3-1d8e11a35b39")] [PInvokeData("filtereg.h", MSDNShortId = "b4eff132-9022-4091-a2a3-1d8e11a35b39")]
[Obsolete, PreserveSig] [Obsolete, PreserveSig]
new HRESULT LoadIFilterFromStorage([In] IStorage pStg, [In, MarshalAs(UnmanagedType.IUnknown)] object pUnkOuter, [In, MarshalAs(UnmanagedType.LPWStr)] string pwcsOverride, new HRESULT LoadIFilterFromStorage([In] IStorage pStg, [In, MarshalAs(UnmanagedType.IUnknown)] object? pUnkOuter, [In, MarshalAs(UnmanagedType.LPWStr)] string pwcsOverride,
[In, MarshalAs(UnmanagedType.Bool)] bool fUseDefault, out Guid pFilterClsid, [Optional] IntPtr SearchDecSize, [Optional] IntPtr pwcsSearchDesc, out IFilter ppIFilt); [In, MarshalAs(UnmanagedType.Bool)] bool fUseDefault, out Guid pFilterClsid, [Optional] IntPtr SearchDecSize, [Optional] IntPtr pwcsSearchDesc, out IFilter ppIFilt);
/// <summary> /// <summary>
@ -6050,7 +6050,7 @@ public static partial class SearchApi
// *pFilterClsid, int *SearchDecSize, WCHAR **pwcsSearchDesc, IFilter **ppIFilt ); // *pFilterClsid, int *SearchDecSize, WCHAR **pwcsSearchDesc, IFilter **ppIFilt );
[PInvokeData("filtereg.h", MSDNShortId = "6a577306-d5ff-43c1-ab9f-3a7437661d2a")] [PInvokeData("filtereg.h", MSDNShortId = "6a577306-d5ff-43c1-ab9f-3a7437661d2a")]
[Obsolete, PreserveSig] [Obsolete, PreserveSig]
new HRESULT LoadIFilterFromStream([In] IStream pStm, in FILTERED_DATA_SOURCES pFilteredSources, [In, MarshalAs(UnmanagedType.IUnknown)] object pUnkOuter, new HRESULT LoadIFilterFromStream([In] IStream pStm, in FILTERED_DATA_SOURCES pFilteredSources, [In, MarshalAs(UnmanagedType.IUnknown)] object? pUnkOuter,
[In, MarshalAs(UnmanagedType.Bool)] bool fUseDefault, out Guid pFilterClsid, [Optional] IntPtr SearchDecSize, [Optional] IntPtr pwcsSearchDesc, out IFilter ppIFilt); [In, MarshalAs(UnmanagedType.Bool)] bool fUseDefault, out Guid pFilterClsid, [Optional] IntPtr SearchDecSize, [Optional] IntPtr pwcsSearchDesc, out IFilter ppIFilt);
/// <summary>Undocumented.</summary> /// <summary>Undocumented.</summary>

2
PInvoke/SearchApi/ShObjIdl.IOpenSearchSource.cs
View File

@ -76,6 +76,6 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/win32/api/shobjidl_core/nf-shobjidl_core-iopensearchsource-getresults // https://docs.microsoft.com/en-us/windows/win32/api/shobjidl_core/nf-shobjidl_core-iopensearchsource-getresults
// HRESULT GetResults( HWND hwnd, LPCWSTR pszQuery, DWORD dwStartIndex, DWORD dwCount, REFIID riid, void **ppv ); // HRESULT GetResults( HWND hwnd, LPCWSTR pszQuery, DWORD dwStartIndex, DWORD dwCount, REFIID riid, void **ppv );
[PreserveSig] [PreserveSig]
HRESULT GetResults(HWND hwnd, [MarshalAs(UnmanagedType.LPWStr)] string pszQuery, uint dwStartIndex, uint dwCount, in Guid riid, [MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 3)] out object ppv); HRESULT GetResults(HWND hwnd, [MarshalAs(UnmanagedType.LPWStr)] string pszQuery, uint dwStartIndex, uint dwCount, in Guid riid, [MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 3)] out object? ppv);
} }
} }

4
PInvoke/SearchApi/ShObjIdl.ISearchFolderItemFactory.cs
View File

@ -143,7 +143,7 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl_core/nf-shobjidl_core-isearchfolderitemfactory-getshellitem // https://docs.microsoft.com/en-us/windows/desktop/api/shobjidl_core/nf-shobjidl_core-isearchfolderitemfactory-getshellitem
// HRESULT GetShellItem( REFIID riid, void **ppv ); // HRESULT GetShellItem( REFIID riid, void **ppv );
[return: MarshalAs(UnmanagedType.IUnknown)] [return: MarshalAs(UnmanagedType.IUnknown)]
object GetShellItem(in Guid riid); object? GetShellItem(in Guid riid);
/// <summary>Gets the search folder as an ITEMIDLIST.</summary> /// <summary>Gets the search folder as an ITEMIDLIST.</summary>
/// <returns> /// <returns>
@ -159,7 +159,7 @@ public static partial class SearchApi
/// <typeparam name="T">Type of the interface to get.</typeparam> /// <typeparam name="T">Type of the interface to get.</typeparam>
/// <param name="sfif">An <see cref="ISearchFolderItemFactory"/> instance.</param> /// <param name="sfif">An <see cref="ISearchFolderItemFactory"/> instance.</param>
/// <returns>Receives the interface pointer requested in <typeparamref name="T"/>.</returns> /// <returns>Receives the interface pointer requested in <typeparamref name="T"/>.</returns>
public static T GetShellItem<T>(this ISearchFolderItemFactory sfif) where T : class => (T)sfif.GetShellItem(typeof(T).GUID); public static T? GetShellItem<T>(this ISearchFolderItemFactory sfif) where T : class => (T?)sfif.GetShellItem(typeof(T).GUID);
/// <summary>CLSID_SearchFolderItemFactory</summary> /// <summary>CLSID_SearchFolderItemFactory</summary>
[PInvokeData("shobjidl_core.h", MSDNShortId = "a684b373-6de4-4b4a-bbae-85e1c5a7e04a")] [PInvokeData("shobjidl_core.h", MSDNShortId = "a684b373-6de4-4b4a-bbae-85e1c5a7e04a")]

203
PInvoke/SearchApi/StructuredQuery.cs
View File

@ -1,4 +1,5 @@
using System.Collections.Generic; using System.Collections.Generic;
using System.Linq;
using static Vanara.PInvoke.Ole32; using static Vanara.PInvoke.Ole32;
using static Vanara.PInvoke.Shell32; using static Vanara.PInvoke.Shell32;
@ -349,7 +350,7 @@ public static partial class SearchApi
/// </remarks> /// </remarks>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory-makeandor HRESULT // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory-makeandor HRESULT
// MakeAndOr( CONDITION_TYPE ct, IEnumUnknown *peuSubs, BOOL fSimplify, ICondition **ppcResult ); // MakeAndOr( CONDITION_TYPE ct, IEnumUnknown *peuSubs, BOOL fSimplify, ICondition **ppcResult );
ICondition MakeAndOr([In] CONDITION_TYPE ct, [In] IEnumUnknown peuSubs, [In, MarshalAs(UnmanagedType.Bool)] bool fSimplify); ICondition MakeAndOr([In] CONDITION_TYPE ct, [In] IEnumUnknown? peuSubs, [In, MarshalAs(UnmanagedType.Bool)] bool fSimplify);
/// <summary>Creates a leaf condition node that represents a comparison of property value and constant value.</summary> /// <summary>Creates a leaf condition node that represents a comparison of property value and constant value.</summary>
/// <param name="pszPropertyName"> /// <param name="pszPropertyName">
@ -370,13 +371,22 @@ public static partial class SearchApi
/// <para>Type: <c>PROPVARIANT const*</c></para> /// <para>Type: <c>PROPVARIANT const*</c></para>
/// <para>The constant value against which the property value should be compared.</para> /// <para>The constant value against which the property value should be compared.</para>
/// </param> /// </param>
/// <param name="richChunk1">The rich chunk1.</param> /// <param name="pPropertyNameTerm">
/// <param name="richChunk2">The rich chunk2.</param> /// <para>Type: <c>IRichChunk*</c></para>
/// <param name="richChunk3">The rich chunk3.</param> /// <para>A pointer to an IRichChunk that identifies the range of the input string that represents the property. It can be <c>NULL</c>.</para>
/// </param>
/// <param name="pOperationTerm">
/// <para>Type: <c>IRichChunk*</c></para>
/// <para>A pointer to an IRichChunk that identifies the range of the input string that represents the operation. It can be <c>NULL</c>.</para>
/// </param>
/// <param name="pValueTerm">
/// <para>Type: <c>IRichChunk*</c></para>
/// <para>A pointer to an IRichChunk that identifies the range of the input string that represents the value. It can be <c>NULL</c>.</para>
/// </param>
/// <param name="fExpand"> /// <param name="fExpand">
/// <para>Type: <c>BOOL</c></para> /// <para>Type: <c>BOOL</c></para>
/// <para> /// <para>
/// If <c>TRUE</c> and pszPropertyName identifies a virtual property, the resulting node is not a leaf node; instead, it is a /// If <c>TRUE</c> and <c>pszPropertyName</c> identifies a virtual property, the resulting node is not a leaf node; instead, it is a
/// disjunction of leaf condition nodes, each of which corresponds to one expansion of the virtual property. /// disjunction of leaf condition nodes, each of which corresponds to one expansion of the virtual property.
/// </para> /// </para>
/// </param> /// </param>
@ -387,15 +397,16 @@ public static partial class SearchApi
/// <remarks> /// <remarks>
/// <para>For more information about leaf node terms (property, value, and operation), see ICondition::GetInputTerms.</para> /// <para>For more information about leaf node terms (property, value, and operation), see ICondition::GetInputTerms.</para>
/// <para> /// <para>
/// A virtual property has one or more metadata items in which the key is "MapsToRelation" and the value is a property name /// A virtual property has one or more metadata items in which the key is "MapsToRelation" and the value is a property name (which is
/// (which is one expansion of the property). For more information about metadata, see MetaData. /// one expansion of the property). For more information about metadata, see MetaData.
/// </para> /// </para>
/// </remarks> /// </remarks>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory-makeleaf HRESULT // https://learn.microsoft.com/en-us/windows/win32/api/structuredquery/nf-structuredquery-iconditionfactory-makeleaf HRESULT
// MakeLeaf( LPCWSTR pszPropertyName, CONDITION_OPERATION cop, LPCWSTR pszValueType, const PROPVARIANT *ppropvar, IRichChunk // MakeLeaf( [in] LPCWSTR pszPropertyName, [in] CONDITION_OPERATION cop, [in] LPCWSTR pszValueType, [in] const PROPVARIANT *ppropvar,
// *pPropertyNameTerm, IRichChunk *pOperationTerm, IRichChunk *pValueTerm, BOOL fExpand, ICondition **ppcResult ); // [in] IRichChunk *pPropertyNameTerm, [in] IRichChunk *pOperationTerm, [in] IRichChunk *pValueTerm, [in] BOOL fExpand, [out, retval]
ICondition MakeLeaf([In, MarshalAs(UnmanagedType.LPWStr)] string pszPropertyName, [In] CONDITION_OPERATION cop, [In, MarshalAs(UnmanagedType.LPWStr)] string pszValueType, // ICondition **ppcResult );
[In] PROPVARIANT ppropvar, [Optional] IRichChunk richChunk1, [Optional] IRichChunk richChunk2, [Optional] IRichChunk richChunk3, [In, Optional, MarshalAs(UnmanagedType.Bool)] bool fExpand); ICondition MakeLeaf([In, MarshalAs(UnmanagedType.LPWStr)] string? pszPropertyName, [In] CONDITION_OPERATION cop, [In, MarshalAs(UnmanagedType.LPWStr)] string? pszValueType,
[In] PROPVARIANT ppropvar, [Optional] IRichChunk? pPropertyNameTerm, [Optional] IRichChunk? pOperationTerm, [Optional] IRichChunk? pValueTerm, [In, Optional, MarshalAs(UnmanagedType.Bool)] bool fExpand);
/// <summary> /// <summary>
/// Performs a variety of transformations on a condition tree, including the following: resolves conditions with relative /// Performs a variety of transformations on a condition tree, including the following: resolves conditions with relative
@ -450,7 +461,7 @@ public static partial class SearchApi
/// </remarks> /// </remarks>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory-resolve HRESULT // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory-resolve HRESULT
// Resolve( ICondition *pc, STRUCTURED_QUERY_RESOLVE_OPTION sqro, const SYSTEMTIME *pstReferenceTime, ICondition **ppcResolved ); // Resolve( ICondition *pc, STRUCTURED_QUERY_RESOLVE_OPTION sqro, const SYSTEMTIME *pstReferenceTime, ICondition **ppcResolved );
ICondition Resolve([In] ICondition pc, STRUCTURED_QUERY_RESOLVE_OPTION sqro, in SYSTEMTIME pstReferenceTime); unsafe ICondition Resolve([In] ICondition pc, STRUCTURED_QUERY_RESOLVE_OPTION sqro, [In, Optional] SYSTEMTIME* pstReferenceTime);
} }
/// <summary> /// <summary>
@ -525,7 +536,7 @@ public static partial class SearchApi
/// </remarks> /// </remarks>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory-makeandor HRESULT // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory-makeandor HRESULT
// MakeAndOr( CONDITION_TYPE ct, IEnumUnknown *peuSubs, BOOL fSimplify, ICondition **ppcResult ); // MakeAndOr( CONDITION_TYPE ct, IEnumUnknown *peuSubs, BOOL fSimplify, ICondition **ppcResult );
new ICondition MakeAndOr([In] CONDITION_TYPE ct, [In] IEnumUnknown peuSubs, [In, MarshalAs(UnmanagedType.Bool)] bool fSimplify); new ICondition MakeAndOr([In] CONDITION_TYPE ct, [In] IEnumUnknown? peuSubs, [In, MarshalAs(UnmanagedType.Bool)] bool fSimplify);
/// <summary>Creates a leaf condition node that represents a comparison of property value and constant value.</summary> /// <summary>Creates a leaf condition node that represents a comparison of property value and constant value.</summary>
/// <param name="pszPropertyName"> /// <param name="pszPropertyName">
@ -546,13 +557,22 @@ public static partial class SearchApi
/// <para>Type: <c>PROPVARIANT const*</c></para> /// <para>Type: <c>PROPVARIANT const*</c></para>
/// <para>The constant value against which the property value should be compared.</para> /// <para>The constant value against which the property value should be compared.</para>
/// </param> /// </param>
/// <param name="richChunk1">The rich chunk1.</param> /// <param name="pPropertyNameTerm">
/// <param name="richChunk2">The rich chunk2.</param> /// <para>Type: <c>IRichChunk*</c></para>
/// <param name="richChunk3">The rich chunk3.</param> /// <para>A pointer to an IRichChunk that identifies the range of the input string that represents the property. It can be <c>NULL</c>.</para>
/// </param>
/// <param name="pOperationTerm">
/// <para>Type: <c>IRichChunk*</c></para>
/// <para>A pointer to an IRichChunk that identifies the range of the input string that represents the operation. It can be <c>NULL</c>.</para>
/// </param>
/// <param name="pValueTerm">
/// <para>Type: <c>IRichChunk*</c></para>
/// <para>A pointer to an IRichChunk that identifies the range of the input string that represents the value. It can be <c>NULL</c>.</para>
/// </param>
/// <param name="fExpand"> /// <param name="fExpand">
/// <para>Type: <c>BOOL</c></para> /// <para>Type: <c>BOOL</c></para>
/// <para> /// <para>
/// If <c>TRUE</c> and pszPropertyName identifies a virtual property, the resulting node is not a leaf node; instead, it is a /// If <c>TRUE</c> and <c>pszPropertyName</c> identifies a virtual property, the resulting node is not a leaf node; instead, it is a
/// disjunction of leaf condition nodes, each of which corresponds to one expansion of the virtual property. /// disjunction of leaf condition nodes, each of which corresponds to one expansion of the virtual property.
/// </para> /// </para>
/// </param> /// </param>
@ -563,15 +583,16 @@ public static partial class SearchApi
/// <remarks> /// <remarks>
/// <para>For more information about leaf node terms (property, value, and operation), see ICondition::GetInputTerms.</para> /// <para>For more information about leaf node terms (property, value, and operation), see ICondition::GetInputTerms.</para>
/// <para> /// <para>
/// A virtual property has one or more metadata items in which the key is "MapsToRelation" and the value is a property name /// A virtual property has one or more metadata items in which the key is "MapsToRelation" and the value is a property name (which is
/// (which is one expansion of the property). For more information about metadata, see MetaData. /// one expansion of the property). For more information about metadata, see MetaData.
/// </para> /// </para>
/// </remarks> /// </remarks>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory-makeleaf HRESULT // https://learn.microsoft.com/en-us/windows/win32/api/structuredquery/nf-structuredquery-iconditionfactory-makeleaf HRESULT
// MakeLeaf( LPCWSTR pszPropertyName, CONDITION_OPERATION cop, LPCWSTR pszValueType, const PROPVARIANT *ppropvar, IRichChunk // MakeLeaf( [in] LPCWSTR pszPropertyName, [in] CONDITION_OPERATION cop, [in] LPCWSTR pszValueType, [in] const PROPVARIANT *ppropvar,
// *pPropertyNameTerm, IRichChunk *pOperationTerm, IRichChunk *pValueTerm, BOOL fExpand, ICondition **ppcResult ); // [in] IRichChunk *pPropertyNameTerm, [in] IRichChunk *pOperationTerm, [in] IRichChunk *pValueTerm, [in] BOOL fExpand, [out, retval]
new ICondition MakeLeaf([In, MarshalAs(UnmanagedType.LPWStr)] string pszPropertyName, [In] CONDITION_OPERATION cop, [In, MarshalAs(UnmanagedType.LPWStr)] string pszValueType, // ICondition **ppcResult );
[In] PROPVARIANT ppropvar, IRichChunk richChunk1, IRichChunk richChunk2, IRichChunk richChunk3, [In, MarshalAs(UnmanagedType.Bool)] bool fExpand); new ICondition MakeLeaf([In, MarshalAs(UnmanagedType.LPWStr)] string? pszPropertyName, [In] CONDITION_OPERATION cop, [In, MarshalAs(UnmanagedType.LPWStr)] string? pszValueType,
[In] PROPVARIANT ppropvar, [Optional] IRichChunk? pPropertyNameTerm, [Optional] IRichChunk? pOperationTerm, [Optional] IRichChunk? pValueTerm, [In, Optional, MarshalAs(UnmanagedType.Bool)] bool fExpand);
/// <summary> /// <summary>
/// Performs a variety of transformations on a condition tree, including the following: resolves conditions with relative /// Performs a variety of transformations on a condition tree, including the following: resolves conditions with relative
@ -593,8 +614,8 @@ public static partial class SearchApi
/// <param name="pstReferenceTime"> /// <param name="pstReferenceTime">
/// <para>Type: <c>SYSTEMTIME const*</c></para> /// <para>Type: <c>SYSTEMTIME const*</c></para>
/// <para> /// <para>
/// A pointer to a <c>SYSTEMTIME</c> value to use as the reference date and time. A null pointer can be passed if /// A pointer to a <c>SYSTEMTIME</c> value to use as the reference date and time. A null pointer can be passed if <paramref
/// <paramref name="sqro"/> is set to SQRO_DONT_RESOLVE_DATETIME. /// name="sqro"/> is set to SQRO_DONT_RESOLVE_DATETIME.
/// </para> /// </para>
/// </param> /// </param>
/// <returns> /// <returns>
@ -626,7 +647,7 @@ public static partial class SearchApi
/// </remarks> /// </remarks>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory-resolve HRESULT // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory-resolve HRESULT
// Resolve( ICondition *pc, STRUCTURED_QUERY_RESOLVE_OPTION sqro, const SYSTEMTIME *pstReferenceTime, ICondition **ppcResolved ); // Resolve( ICondition *pc, STRUCTURED_QUERY_RESOLVE_OPTION sqro, const SYSTEMTIME *pstReferenceTime, ICondition **ppcResolved );
new ICondition Resolve([In] ICondition pc, STRUCTURED_QUERY_RESOLVE_OPTION sqro, in SYSTEMTIME pstReferenceTime); new unsafe ICondition Resolve([In] ICondition pc, STRUCTURED_QUERY_RESOLVE_OPTION sqro, [In, Optional] SYSTEMTIME* pstReferenceTime);
/// <summary> /// <summary>
/// Creates a search condition that is either <c>TRUE</c> or <c>FALSE</c>. The returned object supports ICondition and ICondition2 /// Creates a search condition that is either <c>TRUE</c> or <c>FALSE</c>. The returned object supports ICondition and ICondition2
@ -648,7 +669,7 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory2-createtruefalse // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory2-createtruefalse
// HRESULT CreateTrueFalse( BOOL fVal, CONDITION_CREATION_OPTIONS cco, REFIID riid, void **ppv ); // HRESULT CreateTrueFalse( BOOL fVal, CONDITION_CREATION_OPTIONS cco, REFIID riid, void **ppv );
[return: MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 2)] [return: MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 2)]
object CreateTrueFalse([MarshalAs(UnmanagedType.Bool)] bool fVal, CONDITION_CREATION_OPTIONS cco, in Guid riid); object? CreateTrueFalse([MarshalAs(UnmanagedType.Bool)] bool fVal, CONDITION_CREATION_OPTIONS cco, in Guid riid);
/// <summary> /// <summary>
/// Creates a condition node that is a logical negation (NOT) of another condition (a subnode of this node). /// Creates a condition node that is a logical negation (NOT) of another condition (a subnode of this node).
@ -676,7 +697,7 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory2-createnegation // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory2-createnegation
// HRESULT CreateNegation( ICondition *pcSub, CONDITION_CREATION_OPTIONS cco, REFIID riid, void **ppv ); // HRESULT CreateNegation( ICondition *pcSub, CONDITION_CREATION_OPTIONS cco, REFIID riid, void **ppv );
[return: MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 2)] [return: MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 2)]
object CreateNegation([In] ICondition pcSub, CONDITION_CREATION_OPTIONS cco, in Guid riid); object? CreateNegation([In] ICondition pcSub, CONDITION_CREATION_OPTIONS cco, in Guid riid);
/// <summary> /// <summary>
/// Creates a leaf condition node that is a conjunction (AND) or a disjunction (OR) of a collection of subconditions. The /// Creates a leaf condition node that is a conjunction (AND) or a disjunction (OR) of a collection of subconditions. The
@ -703,7 +724,7 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory2-createcompoundfromobjectarray // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory2-createcompoundfromobjectarray
// HRESULT CreateCompoundFromObjectArray( CONDITION_TYPE ct, IObjectArray *poaSubs, CONDITION_CREATION_OPTIONS cco, REFIID riid, void **ppv ); // HRESULT CreateCompoundFromObjectArray( CONDITION_TYPE ct, IObjectArray *poaSubs, CONDITION_CREATION_OPTIONS cco, REFIID riid, void **ppv );
[return: MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 3)] [return: MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 3)]
object CreateCompoundFromObjectArray(CONDITION_TYPE ct, [In, Optional] IObjectArray poaSubs, CONDITION_CREATION_OPTIONS cco, in Guid riid); object? CreateCompoundFromObjectArray(CONDITION_TYPE ct, [In, Optional] IObjectArray? poaSubs, CONDITION_CREATION_OPTIONS cco, in Guid riid);
/// <summary> /// <summary>
/// Creates a leaf condition node that is a conjunction (AND) or a disjunction (OR) from an array of condition nodes. The /// Creates a leaf condition node that is a conjunction (AND) or a disjunction (OR) from an array of condition nodes. The
@ -729,7 +750,7 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory2-createcompoundfromarray // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory2-createcompoundfromarray
// HRESULT CreateCompoundFromArray( CONDITION_TYPE ct, ICondition **ppcondSubs, ULONG cSubs, CONDITION_CREATION_OPTIONS cco, REFIID riid, void **ppv ); // HRESULT CreateCompoundFromArray( CONDITION_TYPE ct, ICondition **ppcondSubs, ULONG cSubs, CONDITION_CREATION_OPTIONS cco, REFIID riid, void **ppv );
[return: MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 4)] [return: MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 4)]
object CreateCompoundFromArray(CONDITION_TYPE ct, [In, MarshalAs(UnmanagedType.LPArray, ArraySubType = UnmanagedType.IUnknown)] ICondition[] ppcondSubs, uint cSubs, CONDITION_CREATION_OPTIONS cco, in Guid riid); object? CreateCompoundFromArray(CONDITION_TYPE ct, [In, MarshalAs(UnmanagedType.LPArray, ArraySubType = UnmanagedType.IUnknown)] ICondition[] ppcondSubs, uint cSubs, CONDITION_CREATION_OPTIONS cco, in Guid riid);
/// <summary> /// <summary>
/// Creates a leaf condition node for a string value that represents a comparison of property value and constant value. The /// Creates a leaf condition node for a string value that represents a comparison of property value and constant value. The
@ -759,7 +780,7 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory2-createstringleaf // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory2-createstringleaf
// HRESULT CreateStringLeaf( REFPROPERTYKEY propkey, CONDITION_OPERATION cop, LPCWSTR pszValue, LPCWSTR pszLocaleName, CONDITION_CREATION_OPTIONS cco, REFIID riid, void **ppv ); // HRESULT CreateStringLeaf( REFPROPERTYKEY propkey, CONDITION_OPERATION cop, LPCWSTR pszValue, LPCWSTR pszLocaleName, CONDITION_CREATION_OPTIONS cco, REFIID riid, void **ppv );
[return: MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 5)] [return: MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 5)]
object CreateStringLeaf(in PROPERTYKEY propkey, CONDITION_OPERATION cop, [MarshalAs(UnmanagedType.LPWStr), Optional] string? pszValue, object? CreateStringLeaf(in PROPERTYKEY propkey, CONDITION_OPERATION cop, [MarshalAs(UnmanagedType.LPWStr), Optional] string? pszValue,
[MarshalAs(UnmanagedType.LPWStr), Optional] string? pszLocaleName, CONDITION_CREATION_OPTIONS cco, in Guid riid); [MarshalAs(UnmanagedType.LPWStr), Optional] string? pszLocaleName, CONDITION_CREATION_OPTIONS cco, in Guid riid);
/// <summary> /// <summary>
@ -785,7 +806,7 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory2-createintegerleaf // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory2-createintegerleaf
// HRESULT CreateIntegerLeaf( REFPROPERTYKEY propkey, CONDITION_OPERATION cop, INT32 lValue, CONDITION_CREATION_OPTIONS cco, REFIID riid, void **ppv ); // HRESULT CreateIntegerLeaf( REFPROPERTYKEY propkey, CONDITION_OPERATION cop, INT32 lValue, CONDITION_CREATION_OPTIONS cco, REFIID riid, void **ppv );
[return: MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 4)] [return: MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 4)]
object CreateIntegerLeaf(in PROPERTYKEY propkey, CONDITION_OPERATION cop, int lValue, CONDITION_CREATION_OPTIONS cco, in Guid riid); object? CreateIntegerLeaf(in PROPERTYKEY propkey, CONDITION_OPERATION cop, int lValue, CONDITION_CREATION_OPTIONS cco, in Guid riid);
/// <summary> /// <summary>
/// Creates a search condition that is either <c>TRUE</c> or <c>FALSE</c>. The returned object supports ICondition and ICondition2 /// Creates a search condition that is either <c>TRUE</c> or <c>FALSE</c>. The returned object supports ICondition and ICondition2
@ -808,7 +829,7 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory2-createbooleanleaf // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory2-createbooleanleaf
// HRESULT CreateBooleanLeaf( REFPROPERTYKEY propkey, CONDITION_OPERATION cop, BOOL fValue, CONDITION_CREATION_OPTIONS cco, REFIID riid, void **ppv ); // HRESULT CreateBooleanLeaf( REFPROPERTYKEY propkey, CONDITION_OPERATION cop, BOOL fValue, CONDITION_CREATION_OPTIONS cco, REFIID riid, void **ppv );
[return: MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 4)] [return: MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 4)]
object CreateBooleanLeaf(in PROPERTYKEY propkey, CONDITION_OPERATION cop, [MarshalAs(UnmanagedType.Bool)] bool fValue, CONDITION_CREATION_OPTIONS cco, in Guid riid); object? CreateBooleanLeaf(in PROPERTYKEY propkey, CONDITION_OPERATION cop, [MarshalAs(UnmanagedType.Bool)] bool fValue, CONDITION_CREATION_OPTIONS cco, in Guid riid);
/// <summary>Creates a leaf condition node for any value. The returned object supports ICondition and ICondition2.</summary> /// <summary>Creates a leaf condition node for any value. The returned object supports ICondition and ICondition2.</summary>
/// <param name="propkey"><para>Type: <c>REFPROPERTYKEY</c></para> /// <param name="propkey"><para>Type: <c>REFPROPERTYKEY</c></para>
@ -858,9 +879,9 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory2-createleaf // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory2-createleaf
// HRESULT CreateLeaf( REFPROPERTYKEY propkey, CONDITION_OPERATION cop, REFPROPVARIANT propvar, LPCWSTR pszSemanticType, LPCWSTR pszLocaleName, IRichChunk *pPropertyNameTerm, IRichChunk *pOperationTerm, IRichChunk *pValueTerm, CONDITION_CREATION_OPTIONS cco, REFIID riid, void **ppv ); // HRESULT CreateLeaf( REFPROPERTYKEY propkey, CONDITION_OPERATION cop, REFPROPVARIANT propvar, LPCWSTR pszSemanticType, LPCWSTR pszLocaleName, IRichChunk *pPropertyNameTerm, IRichChunk *pOperationTerm, IRichChunk *pValueTerm, CONDITION_CREATION_OPTIONS cco, REFIID riid, void **ppv );
[return: MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 9)] [return: MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 9)]
object CreateLeaf(in PROPERTYKEY propkey, CONDITION_OPERATION cop, [In] PROPVARIANT propvar, [In, Optional, MarshalAs(UnmanagedType.LPWStr)] string? pszSemanticType, object? CreateLeaf(in PROPERTYKEY propkey, CONDITION_OPERATION cop, [In] PROPVARIANT propvar, [In, Optional, MarshalAs(UnmanagedType.LPWStr)] string? pszSemanticType,
[In, Optional, MarshalAs(UnmanagedType.LPWStr)] string? pszLocaleName, [In, Optional] IRichChunk pPropertyNameTerm, [In, Optional] IRichChunk pOperationTerm, [In, Optional, MarshalAs(UnmanagedType.LPWStr)] string? pszLocaleName, [In, Optional] IRichChunk? pPropertyNameTerm, [In, Optional] IRichChunk? pOperationTerm,
[In, Optional] IRichChunk pValueTerm, CONDITION_CREATION_OPTIONS cco, in Guid riid); [In, Optional] IRichChunk? pValueTerm, CONDITION_CREATION_OPTIONS cco, in Guid riid);
/// <summary> /// <summary>
/// Performs a variety of transformations on a condition tree, and thereby the resolved condition for evaluation. The returned /// Performs a variety of transformations on a condition tree, and thereby the resolved condition for evaluation. The returned
@ -894,7 +915,7 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory2-resolvecondition // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory2-resolvecondition
// HRESULT ResolveCondition( ICondition *pc, STRUCTURED_QUERY_RESOLVE_OPTION sqro, const SYSTEMTIME *pstReferenceTime, REFIID riid, void **ppv ); // HRESULT ResolveCondition( ICondition *pc, STRUCTURED_QUERY_RESOLVE_OPTION sqro, const SYSTEMTIME *pstReferenceTime, REFIID riid, void **ppv );
[return: MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 3)] [return: MarshalAs(UnmanagedType.IUnknown, IidParameterIndex = 3)]
object ResolveCondition([In] ICondition pc, STRUCTURED_QUERY_RESOLVE_OPTION sqro, in SYSTEMTIME pstReferenceTime, in Guid riid); unsafe object? ResolveCondition([In] ICondition pc, STRUCTURED_QUERY_RESOLVE_OPTION sqro, [In] SYSTEMTIME* pstReferenceTime, in Guid riid);
} }
/// <summary>Provides methods for retrieving information about an entity type in the schema.</summary> /// <summary>Provides methods for retrieving information about an entity type in the schema.</summary>
@ -946,7 +967,7 @@ public static partial class SearchApi
/// </remarks> /// </remarks>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-ientity-base HRESULT Base( IEntity // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-ientity-base HRESULT Base( IEntity
// **pBaseEntity ); // **pBaseEntity );
HRESULT Base(out IEntity pBaseEntity); HRESULT Base(out IEntity? pBaseEntity);
/// <summary>Retrieves an enumeration of IRelationship objects, one for each relationship this entity has.</summary> /// <summary>Retrieves an enumeration of IRelationship objects, one for each relationship this entity has.</summary>
/// <param name="riid"> /// <param name="riid">
@ -960,7 +981,7 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-ientity-relationships HRESULT // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-ientity-relationships HRESULT
// Relationships( REFIID riid, void **pRelationships ); // Relationships( REFIID riid, void **pRelationships );
[return: MarshalAs(UnmanagedType.IUnknown)] [return: MarshalAs(UnmanagedType.IUnknown)]
object Relationships(in Guid riid); object? Relationships(in Guid riid);
/// <summary>Retrieves the IRelationship object for this entity as requested by name.</summary> /// <summary>Retrieves the IRelationship object for this entity as requested by name.</summary>
/// <param name="pszRelationName"> /// <param name="pszRelationName">
@ -976,7 +997,7 @@ public static partial class SearchApi
/// </returns> /// </returns>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-ientity-getrelationship HRESULT // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-ientity-getrelationship HRESULT
// GetRelationship( LPCWSTR pszRelationName, IRelationship **pRelationship ); // GetRelationship( LPCWSTR pszRelationName, IRelationship **pRelationship );
IRelationship GetRelationship([In, MarshalAs(UnmanagedType.LPWStr)] string pszRelationName); IRelationship? GetRelationship([In, MarshalAs(UnmanagedType.LPWStr)] string pszRelationName);
/// <summary> /// <summary>
/// <para>Retrieves an enumeration of IMetaData objects for this entity.</para> /// <para>Retrieves an enumeration of IMetaData objects for this entity.</para>
@ -1021,7 +1042,7 @@ public static partial class SearchApi
/// </returns> /// </returns>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-ientity-getnamedentity HRESULT // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-ientity-getnamedentity HRESULT
// GetNamedEntity( LPCWSTR pszValue, INamedEntity **ppNamedEntity ); // GetNamedEntity( LPCWSTR pszValue, INamedEntity **ppNamedEntity );
INamedEntity GetNamedEntity([In, MarshalAs(UnmanagedType.LPWStr)] string pszValue); INamedEntity? GetNamedEntity([In, MarshalAs(UnmanagedType.LPWStr)] string pszValue);
/// <summary>Retrieves a default phrase to use for this entity in restatements.</summary> /// <summary>Retrieves a default phrase to use for this entity in restatements.</summary>
/// <returns> /// <returns>
@ -1128,7 +1149,7 @@ public static partial class SearchApi
/// </remarks> /// </remarks>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iqueryparser-parse HRESULT Parse( // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iqueryparser-parse HRESULT Parse(
// LPCWSTR pszInputString, IEnumUnknown *pCustomProperties, IQuerySolution **ppSolution ); // LPCWSTR pszInputString, IEnumUnknown *pCustomProperties, IQuerySolution **ppSolution );
IQuerySolution Parse([In, MarshalAs(UnmanagedType.LPWStr)] string pszInputString, [In, Optional] IEnumUnknown pCustomProperties); IQuerySolution Parse([In, MarshalAs(UnmanagedType.LPWStr)] string pszInputString, [In, Optional] IEnumUnknown? pCustomProperties);
/// <summary>Sets a single option, such as a specified word-breaker, for parsing an input string.</summary> /// <summary>Sets a single option, such as a specified word-breaker, for parsing an input string.</summary>
/// <param name="option"> /// <param name="option">
@ -1443,13 +1464,22 @@ public static partial class SearchApi
/// <para>Type: <c>PROPVARIANT const*</c></para> /// <para>Type: <c>PROPVARIANT const*</c></para>
/// <para>The constant value against which the property value should be compared.</para> /// <para>The constant value against which the property value should be compared.</para>
/// </param> /// </param>
/// <param name="richChunk1">The rich chunk1.</param> /// <param name="pPropertyNameTerm">
/// <param name="richChunk2">The rich chunk2.</param> /// <para>Type: <c>IRichChunk*</c></para>
/// <param name="richChunk3">The rich chunk3.</param> /// <para>A pointer to an IRichChunk that identifies the range of the input string that represents the property. It can be <c>NULL</c>.</para>
/// </param>
/// <param name="pOperationTerm">
/// <para>Type: <c>IRichChunk*</c></para>
/// <para>A pointer to an IRichChunk that identifies the range of the input string that represents the operation. It can be <c>NULL</c>.</para>
/// </param>
/// <param name="pValueTerm">
/// <para>Type: <c>IRichChunk*</c></para>
/// <para>A pointer to an IRichChunk that identifies the range of the input string that represents the value. It can be <c>NULL</c>.</para>
/// </param>
/// <param name="fExpand"> /// <param name="fExpand">
/// <para>Type: <c>BOOL</c></para> /// <para>Type: <c>BOOL</c></para>
/// <para> /// <para>
/// If <c>TRUE</c> and pszPropertyName identifies a virtual property, the resulting node is not a leaf node; instead, it is a /// If <c>TRUE</c> and <c>pszPropertyName</c> identifies a virtual property, the resulting node is not a leaf node; instead, it is a
/// disjunction of leaf condition nodes, each of which corresponds to one expansion of the virtual property. /// disjunction of leaf condition nodes, each of which corresponds to one expansion of the virtual property.
/// </para> /// </para>
/// </param> /// </param>
@ -1460,15 +1490,16 @@ public static partial class SearchApi
/// <remarks> /// <remarks>
/// <para>For more information about leaf node terms (property, value, and operation), see ICondition::GetInputTerms.</para> /// <para>For more information about leaf node terms (property, value, and operation), see ICondition::GetInputTerms.</para>
/// <para> /// <para>
/// A virtual property has one or more metadata items in which the key is "MapsToRelation" and the value is a property name /// A virtual property has one or more metadata items in which the key is "MapsToRelation" and the value is a property name (which is
/// (which is one expansion of the property). For more information about metadata, see MetaData. /// one expansion of the property). For more information about metadata, see MetaData.
/// </para> /// </para>
/// </remarks> /// </remarks>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory-makeleaf HRESULT // https://learn.microsoft.com/en-us/windows/win32/api/structuredquery/nf-structuredquery-iconditionfactory-makeleaf HRESULT
// MakeLeaf( LPCWSTR pszPropertyName, CONDITION_OPERATION cop, LPCWSTR pszValueType, const PROPVARIANT *ppropvar, IRichChunk // MakeLeaf( [in] LPCWSTR pszPropertyName, [in] CONDITION_OPERATION cop, [in] LPCWSTR pszValueType, [in] const PROPVARIANT *ppropvar,
// *pPropertyNameTerm, IRichChunk *pOperationTerm, IRichChunk *pValueTerm, BOOL fExpand, ICondition **ppcResult ); // [in] IRichChunk *pPropertyNameTerm, [in] IRichChunk *pOperationTerm, [in] IRichChunk *pValueTerm, [in] BOOL fExpand, [out, retval]
new ICondition MakeLeaf([In, MarshalAs(UnmanagedType.LPWStr)] string pszPropertyName, [In] CONDITION_OPERATION cop, [In, MarshalAs(UnmanagedType.LPWStr)] string pszValueType, // ICondition **ppcResult );
[In] PROPVARIANT ppropvar, IRichChunk richChunk1, IRichChunk richChunk2, IRichChunk richChunk3, [In, MarshalAs(UnmanagedType.Bool)] bool fExpand); new ICondition MakeLeaf([In, MarshalAs(UnmanagedType.LPWStr)] string? pszPropertyName, [In] CONDITION_OPERATION cop, [In, MarshalAs(UnmanagedType.LPWStr)] string? pszValueType,
[In] PROPVARIANT ppropvar, [Optional] IRichChunk? pPropertyNameTerm, [Optional] IRichChunk? pOperationTerm, [Optional] IRichChunk? pValueTerm, [In, Optional, MarshalAs(UnmanagedType.Bool)] bool fExpand);
/// <summary> /// <summary>
/// Performs a variety of transformations on a condition tree, including the following: resolves conditions with relative /// Performs a variety of transformations on a condition tree, including the following: resolves conditions with relative
@ -1523,7 +1554,7 @@ public static partial class SearchApi
/// </remarks> /// </remarks>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory-resolve HRESULT // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iconditionfactory-resolve HRESULT
// Resolve( ICondition *pc, STRUCTURED_QUERY_RESOLVE_OPTION sqro, const SYSTEMTIME *pstReferenceTime, ICondition **ppcResolved ); // Resolve( ICondition *pc, STRUCTURED_QUERY_RESOLVE_OPTION sqro, const SYSTEMTIME *pstReferenceTime, ICondition **ppcResolved );
new ICondition Resolve([In] ICondition pc, STRUCTURED_QUERY_RESOLVE_OPTION sqro, in SYSTEMTIME pstReferenceTime); new unsafe ICondition Resolve([In] ICondition pc, STRUCTURED_QUERY_RESOLVE_OPTION sqro, [In] SYSTEMTIME* pstReferenceTime);
/// <summary>Retrieves the condition tree and the semantic type of the solution.</summary> /// <summary>Retrieves the condition tree and the semantic type of the solution.</summary>
/// <param name="ppQueryNode"> /// <param name="ppQueryNode">
@ -1540,7 +1571,7 @@ public static partial class SearchApi
/// </param> /// </param>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iquerysolution-getquery HRESULT // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iquerysolution-getquery HRESULT
// GetQuery( ICondition **ppQueryNode, IEntity **ppMainType ); // GetQuery( ICondition **ppQueryNode, IEntity **ppMainType );
void GetQuery(out ICondition ppQueryNode, out IEntity ppMainType); void GetQuery(out ICondition? ppQueryNode, out IEntity? ppMainType);
/// <summary> /// <summary>
/// Identifies parts of the input string that the parser did not recognize or did not use when constructing the IQuerySolution /// Identifies parts of the input string that the parser did not recognize or did not use when constructing the IQuerySolution
@ -1565,7 +1596,7 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iquerysolution-geterrors HRESULT // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iquerysolution-geterrors HRESULT
// GetErrors( REFIID riid, void **ppParseErrors ); // GetErrors( REFIID riid, void **ppParseErrors );
[return: MarshalAs(UnmanagedType.IUnknown)] [return: MarshalAs(UnmanagedType.IUnknown)]
object GetErrors(in Guid riid); object? GetErrors(in Guid riid);
/// <summary> /// <summary>
/// Reports the query string, how it was tokenized, and what language code identifier (LCID) and word breaker were used to parse it. /// Reports the query string, how it was tokenized, and what language code identifier (LCID) and word breaker were used to parse it.
@ -1590,8 +1621,8 @@ public static partial class SearchApi
/// </param> /// </param>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iquerysolution-getlexicaldata HRESULT // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-iquerysolution-getlexicaldata HRESULT
// GetLexicalData( LPWSTR *ppszInputString, ITokenCollection **ppTokens, LCID *plcid, IUnknown **ppWordBreaker ); // GetLexicalData( LPWSTR *ppszInputString, ITokenCollection **ppTokens, LCID *plcid, IUnknown **ppWordBreaker );
void GetLexicalData([MarshalAs(UnmanagedType.LPWStr)] out string ppszInputString, [Out] out ITokenCollection ppTokens, [Out] out uint plcid, void GetLexicalData([MarshalAs(UnmanagedType.LPWStr)] out string? ppszInputString, [Out] out ITokenCollection? ppTokens, [Out] out uint plcid,
[Out, MarshalAs(UnmanagedType.IUnknown)] out object ppWordBreaker); [Out, MarshalAs(UnmanagedType.IUnknown)] out object? ppWordBreaker);
} }
/// <summary>Provides methods for retrieving information about a schema property.</summary> /// <summary>Provides methods for retrieving information about a schema property.</summary>
@ -1639,7 +1670,7 @@ public static partial class SearchApi
/// </returns> /// </returns>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-irelationship-destination HRESULT // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-irelationship-destination HRESULT
// Destination( IEntity **pDestinationEntity ); // Destination( IEntity **pDestinationEntity );
IEntity Destination(); IEntity? Destination();
/// <summary>Retrieves an enumeration of IMetaData objects for this relationship.</summary> /// <summary>Retrieves an enumeration of IMetaData objects for this relationship.</summary>
/// <param name="riid"> /// <param name="riid">
@ -1655,7 +1686,7 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-irelationship-metadata HRESULT // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-irelationship-metadata HRESULT
// MetaData( REFIID riid, void **pMetaData ); // MetaData( REFIID riid, void **pMetaData );
[return: MarshalAs(UnmanagedType.IUnknown)] [return: MarshalAs(UnmanagedType.IUnknown)]
object MetaData(in Guid riid); object? MetaData(in Guid riid);
/// <summary>Retrieves the default phrase to use for this relationship in restatements.</summary> /// <summary>Retrieves the default phrase to use for this relationship in restatements.</summary>
/// <returns> /// <returns>
@ -1697,7 +1728,7 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-ischemalocalizersupport-localize // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-ischemalocalizersupport-localize
// HRESULT Localize( LPCWSTR pszGlobalString, LPWSTR *ppszLocalString ); // HRESULT Localize( LPCWSTR pszGlobalString, LPWSTR *ppszLocalString );
[PreserveSig] [PreserveSig]
HRESULT Localize([MarshalAs(UnmanagedType.LPWStr)] string pszGlobalString, [MarshalAs(UnmanagedType.LPWStr)] out string ppszLocalString); HRESULT Localize([MarshalAs(UnmanagedType.LPWStr)] string pszGlobalString, [MarshalAs(UnmanagedType.LPWStr)] out string? ppszLocalString);
} }
/// <summary>Provides a schema repository that can be browsed.</summary> /// <summary>Provides a schema repository that can be browsed.</summary>
@ -1745,7 +1776,7 @@ public static partial class SearchApi
/// </returns> /// </returns>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-ischemaprovider-getentity HRESULT // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-ischemaprovider-getentity HRESULT
// GetEntity( LPCWSTR pszEntityName, IEntity **pEntity ); // GetEntity( LPCWSTR pszEntityName, IEntity **pEntity );
IEntity GetEntity([In, MarshalAs(UnmanagedType.LPWStr)] string pszEntityName); IEntity GetEntity([In, MarshalAs(UnmanagedType.LPWStr)] string? pszEntityName);
/// <summary>Retrieves an enumeration of global IMetaData objects for the loaded schema.</summary> /// <summary>Retrieves an enumeration of global IMetaData objects for the loaded schema.</summary>
/// <param name="riid"> /// <param name="riid">
@ -1762,7 +1793,7 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-ischemaprovider-metadata HRESULT // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-ischemaprovider-metadata HRESULT
// MetaData( REFIID riid, void **pMetaData ); // MetaData( REFIID riid, void **pMetaData );
[return: MarshalAs(UnmanagedType.IUnknown)] [return: MarshalAs(UnmanagedType.IUnknown)]
object MetaData(in Guid riid); object? MetaData(in Guid riid);
/// <summary>Localizes the currently loaded schema for a specified locale.</summary> /// <summary>Localizes the currently loaded schema for a specified locale.</summary>
/// <param name="lcid"> /// <param name="lcid">
@ -1873,7 +1904,7 @@ public static partial class SearchApi
/// </param> /// </param>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-itokencollection-gettoken HRESULT // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquery/nf-structuredquery-itokencollection-gettoken HRESULT
// GetToken( ULONG i, ULONG *pBegin, ULONG *pLength, LPWSTR *ppsz ); // GetToken( ULONG i, ULONG *pBegin, ULONG *pLength, LPWSTR *ppsz );
void GetToken(uint i, out uint pBegin, out uint pLength, [Out, MarshalAs(UnmanagedType.LPWStr)] out string ppsz); void GetToken(uint i, out uint pBegin, out uint pLength, [Out, MarshalAs(UnmanagedType.LPWStr)] out string? ppsz);
} }
/// <summary> /// <summary>
@ -1923,7 +1954,7 @@ public static partial class SearchApi
/// identifying the STRUCTURED_QUERY_PARSE_ERROR enumeration. /// identifying the STRUCTURED_QUERY_PARSE_ERROR enumeration.
/// </para> /// </para>
/// </remarks> /// </remarks>
public static IEnumerable<IRichChunk> GetErrors(this IQuerySolution qs) => ((IEnumUnknown)qs.GetErrors(typeof(IEnumUnknown).GUID)).Enumerate<IRichChunk>(); public static IEnumerable<IRichChunk> GetErrors(this IQuerySolution qs) => ((IEnumUnknown?)qs.GetErrors(typeof(IEnumUnknown).GUID))?.EnumerateNonNulls<IRichChunk>() ?? Enumerable.Empty<IRichChunk>();
/// <summary>Retrieves an enumeration of IMetaData objects for this entity.</summary> /// <summary>Retrieves an enumeration of IMetaData objects for this entity.</summary>
/// <typeparam name="T">The desired type of the result, either IID_IEnumUnknown or IID_IEnumVARIANT.</typeparam> /// <typeparam name="T">The desired type of the result, either IID_IEnumUnknown or IID_IEnumVARIANT.</typeparam>
@ -1937,7 +1968,7 @@ public static partial class SearchApi
/// <returns> /// <returns>
/// Receives a pointer to the enumeration of IMetaData objects. There may be multiple pairs with the same key (or the same value). /// Receives a pointer to the enumeration of IMetaData objects. There may be multiple pairs with the same key (or the same value).
/// </returns> /// </returns>
public static T MetaData<T>(this IRelationship r) where T : class => (T)r.MetaData(typeof(T).GUID); public static T? MetaData<T>(this IRelationship r) where T : class => (T?)r.MetaData(typeof(T).GUID);
/// <summary>Retrieves an enumeration of global IMetaData objects for the loaded schema.</summary> /// <summary>Retrieves an enumeration of global IMetaData objects for the loaded schema.</summary>
/// <typeparam name="T">The desired type of the result, either IID_IEnumUnknown or IID_IEnumVARIANT.</typeparam> /// <typeparam name="T">The desired type of the result, either IID_IEnumUnknown or IID_IEnumVARIANT.</typeparam>
@ -1946,7 +1977,7 @@ public static partial class SearchApi
/// Receives a pointer to an enumeration of the IMetaData objects. The calling application must release it by calling its /// Receives a pointer to an enumeration of the IMetaData objects. The calling application must release it by calling its
/// IUnknown::Release method. /// IUnknown::Release method.
/// </returns> /// </returns>
public static T MetaData<T>(this ISchemaProvider sp) => (T)sp.MetaData(typeof(T).GUID); public static T? MetaData<T>(this ISchemaProvider sp) => (T?)sp.MetaData(typeof(T).GUID);
/// <summary>Retrieves an enumeration of INamedEntity objects, one for each known named entity of this type.</summary> /// <summary>Retrieves an enumeration of INamedEntity objects, one for each known named entity of this type.</summary>
/// <typeparam name="T">The desired type of the result, either IID_IEnumUnknown or IID_IEnumVARIANT.</typeparam> /// <typeparam name="T">The desired type of the result, either IID_IEnumUnknown or IID_IEnumVARIANT.</typeparam>
@ -1960,7 +1991,7 @@ public static partial class SearchApi
/// <typeparam name="T">The desired type of the result, either IID_IEnumUnknown or IID_IEnumVARIANT.</typeparam> /// <typeparam name="T">The desired type of the result, either IID_IEnumUnknown or IID_IEnumVARIANT.</typeparam>
/// <param name="e">The <see cref="IEntity"/> instance.</param> /// <param name="e">The <see cref="IEntity"/> instance.</param>
/// <returns>Receives the address of a pointer to the enumeration of the IRelationship objects.</returns> /// <returns>Receives the address of a pointer to the enumeration of the IRelationship objects.</returns>
public static T Relationships<T>(this IEntity e) where T : class => (T)e.Relationships(typeof(T).GUID); public static T? Relationships<T>(this IEntity e) where T : class => (T?)e.Relationships(typeof(T).GUID);
/// <summary> /// <summary>
/// Performs a variety of transformations on a condition tree, and thereby the resolved condition for evaluation. The returned /// Performs a variety of transformations on a condition tree, and thereby the resolved condition for evaluation. The returned
@ -1976,10 +2007,36 @@ public static partial class SearchApi
/// automatically added to sqro. /// automatically added to sqro.
/// </para></param> /// </para></param>
/// <returns></returns> /// <returns></returns>
public static T ResolveCondition<T>(this IConditionFactory2 f2, ICondition pc, STRUCTURED_QUERY_RESOLVE_OPTION sqro = 0) where T : class public static T? ResolveCondition<T>(this IConditionFactory2 f2, ICondition pc, STRUCTURED_QUERY_RESOLVE_OPTION sqro = STRUCTURED_QUERY_RESOLVE_OPTION.SQRO_DONT_RESOLVE_DATETIME) where T : class
{ {
Kernel32.GetLocalTime(out var st); unsafe
return (T)f2.ResolveCondition(pc, sqro, st, typeof(T).GUID); {
return (T?)f2.ResolveCondition(pc, sqro | STRUCTURED_QUERY_RESOLVE_OPTION.SQRO_DONT_RESOLVE_DATETIME, null, typeof(T).GUID);
}
}
/// <summary>
/// Performs a variety of transformations on a condition tree, and thereby the resolved condition for evaluation. The returned
/// object supports ICondition and ICondition2.
/// </summary>
/// <typeparam name="T">The desired type of the result, either ICondition or ICondition2.</typeparam>
/// <param name="f2">The IConditionFactory2 instance.</param>
/// <param name="pc"><para>Type: <c>ICondition*</c></para>
/// <para>Pointer to an ICondition object to be resolved.</para></param>
/// <param name="refTime">The value to use as the reference date and time.</param>
/// <param name="sqro"><para>Type: <c>STRUCTURED_QUERY_RESOLVE_OPTION</c></para>
/// <para>
/// Specifies zero or more of the STRUCTURED_QUERY_RESOLVE_OPTION flags. The SQRO_NULL_VALUE_TYPE_FOR_PLAIN_VALUES flag is
/// automatically added to sqro.
/// </para></param>
/// <returns></returns>
public static T? ResolveCondition<T>(this IConditionFactory2 f2, ICondition pc, DateTime refTime, STRUCTURED_QUERY_RESOLVE_OPTION sqro = 0) where T : class
{
unsafe
{
SYSTEMTIME st = new(refTime);
return (T?)f2.ResolveCondition(pc, sqro, &st, typeof(T).GUID);
}
} }
/// <summary>Class interface for ICondition</summary> /// <summary>Class interface for ICondition</summary>

16
PInvoke/SearchApi/StructuredQueryCondition.cs
View File

@ -373,7 +373,7 @@ public static partial class SearchApi
/// <remarks>Any or all of the three parameters can be <c>NULL</c>.</remarks> /// <remarks>Any or all of the three parameters can be <c>NULL</c>.</remarks>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquerycondition/nf-structuredquerycondition-icondition-getcomparisoninfo // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquerycondition/nf-structuredquerycondition-icondition-getcomparisoninfo
// HRESULT GetComparisonInfo( LPWSTR *ppszPropertyName, CONDITION_OPERATION *pcop, PROPVARIANT *ppropvar ); // HRESULT GetComparisonInfo( LPWSTR *ppszPropertyName, CONDITION_OPERATION *pcop, PROPVARIANT *ppropvar );
void GetComparisonInfo([Out, MarshalAs(UnmanagedType.LPWStr)] out string ppszPropertyName, out CONDITION_OPERATION pcop, [In, Out] PROPVARIANT ppropvar); void GetComparisonInfo([Out, MarshalAs(UnmanagedType.LPWStr)] out string? ppszPropertyName, out CONDITION_OPERATION pcop, [In, Out] PROPVARIANT ppropvar);
/// <summary>Retrieves the semantic type of the value of the search condition node.</summary> /// <summary>Retrieves the semantic type of the value of the search condition node.</summary>
/// <returns> /// <returns>
@ -383,7 +383,7 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquerycondition/nf-structuredquerycondition-icondition-getvaluetype // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquerycondition/nf-structuredquerycondition-icondition-getvaluetype
// HRESULT GetValueType( LPWSTR *ppszValueTypeName ); // HRESULT GetValueType( LPWSTR *ppszValueTypeName );
[return: MarshalAs(UnmanagedType.LPWStr)] [return: MarshalAs(UnmanagedType.LPWStr)]
string GetValueType(); string? GetValueType();
/// <summary>Retrieves the character-normalized value of the search condition node.</summary> /// <summary>Retrieves the character-normalized value of the search condition node.</summary>
/// <returns> /// <returns>
@ -436,7 +436,7 @@ public static partial class SearchApi
/// </remarks> /// </remarks>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquerycondition/nf-structuredquerycondition-icondition-getinputterms // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquerycondition/nf-structuredquerycondition-icondition-getinputterms
// HRESULT GetInputTerms( IRichChunk **ppPropertyTerm, IRichChunk **ppOperationTerm, IRichChunk **ppValueTerm ); // HRESULT GetInputTerms( IRichChunk **ppPropertyTerm, IRichChunk **ppOperationTerm, IRichChunk **ppValueTerm );
void GetInputTerms(out IRichChunk ppPropertyTerm, out IRichChunk ppOperationTerm, out IRichChunk ppValueTerm); void GetInputTerms(out IRichChunk? ppPropertyTerm, out IRichChunk? ppOperationTerm, out IRichChunk? ppValueTerm);
/// <summary>Creates a deep copy of this ICondition object.</summary> /// <summary>Creates a deep copy of this ICondition object.</summary>
/// <returns> /// <returns>
@ -710,7 +710,7 @@ public static partial class SearchApi
/// <remarks>Any or all of the three parameters can be <c>NULL</c>.</remarks> /// <remarks>Any or all of the three parameters can be <c>NULL</c>.</remarks>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquerycondition/nf-structuredquerycondition-icondition-getcomparisoninfo // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquerycondition/nf-structuredquerycondition-icondition-getcomparisoninfo
// HRESULT GetComparisonInfo( LPWSTR *ppszPropertyName, CONDITION_OPERATION *pcop, PROPVARIANT *ppropvar ); // HRESULT GetComparisonInfo( LPWSTR *ppszPropertyName, CONDITION_OPERATION *pcop, PROPVARIANT *ppropvar );
new void GetComparisonInfo([Out, MarshalAs(UnmanagedType.LPWStr)] out string ppszPropertyName, out CONDITION_OPERATION pcop, [In, Out] PROPVARIANT ppropvar); new void GetComparisonInfo([Out, MarshalAs(UnmanagedType.LPWStr)] out string? ppszPropertyName, out CONDITION_OPERATION pcop, [In, Out] PROPVARIANT ppropvar);
/// <summary>Retrieves the semantic type of the value of the search condition node.</summary> /// <summary>Retrieves the semantic type of the value of the search condition node.</summary>
/// <returns> /// <returns>
@ -720,7 +720,7 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquerycondition/nf-structuredquerycondition-icondition-getvaluetype // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquerycondition/nf-structuredquerycondition-icondition-getvaluetype
// HRESULT GetValueType( LPWSTR *ppszValueTypeName ); // HRESULT GetValueType( LPWSTR *ppszValueTypeName );
[return: MarshalAs(UnmanagedType.LPWStr)] [return: MarshalAs(UnmanagedType.LPWStr)]
new string GetValueType(); new string? GetValueType();
/// <summary>Retrieves the character-normalized value of the search condition node.</summary> /// <summary>Retrieves the character-normalized value of the search condition node.</summary>
/// <returns> /// <returns>
@ -773,7 +773,7 @@ public static partial class SearchApi
/// </remarks> /// </remarks>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquerycondition/nf-structuredquerycondition-icondition-getinputterms // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquerycondition/nf-structuredquerycondition-icondition-getinputterms
// HRESULT GetInputTerms( IRichChunk **ppPropertyTerm, IRichChunk **ppOperationTerm, IRichChunk **ppValueTerm ); // HRESULT GetInputTerms( IRichChunk **ppPropertyTerm, IRichChunk **ppOperationTerm, IRichChunk **ppValueTerm );
new void GetInputTerms(out IRichChunk ppPropertyTerm, out IRichChunk ppOperationTerm, out IRichChunk ppValueTerm); new void GetInputTerms(out IRichChunk? ppPropertyTerm, out IRichChunk? ppOperationTerm, out IRichChunk? ppValueTerm);
/// <summary>Creates a deep copy of this ICondition object.</summary> /// <summary>Creates a deep copy of this ICondition object.</summary>
/// <returns> /// <returns>
@ -799,7 +799,7 @@ public static partial class SearchApi
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquerycondition/nf-structuredquerycondition-icondition2-getlocale // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquerycondition/nf-structuredquerycondition-icondition2-getlocale
// HRESULT GetLocale( LPWSTR *ppszLocaleName ); // HRESULT GetLocale( LPWSTR *ppszLocaleName );
[PInvokeData("structuredquerycondition.h", MSDNShortId = "")] [PInvokeData("structuredquerycondition.h", MSDNShortId = "")]
string GetLocale(); string? GetLocale();
/// <summary> /// <summary>
/// Retrieves the property name, operation, and value from a leaf search condition node. /// Retrieves the property name, operation, and value from a leaf search condition node.
@ -854,7 +854,7 @@ public static partial class SearchApi
/// </remarks> /// </remarks>
// https://docs.microsoft.com/en-us/windows/desktop/api/structuredquerycondition/nf-structuredquerycondition-irichchunk-getdata // https://docs.microsoft.com/en-us/windows/desktop/api/structuredquerycondition/nf-structuredquerycondition-irichchunk-getdata
// HRESULT GetData( ULONG *pFirstPos, ULONG *pLength, LPWSTR *ppsz, PROPVARIANT *pValue ); // HRESULT GetData( ULONG *pFirstPos, ULONG *pLength, LPWSTR *ppsz, PROPVARIANT *pValue );
void GetData(out uint pFirstPos, out uint pLength, [Out, MarshalAs(UnmanagedType.LPWStr)] out string ppsz, [In, Out] PROPVARIANT pValue); void GetData(out uint pFirstPos, out uint pLength, [Out, MarshalAs(UnmanagedType.LPWStr)] out string? ppsz, [In, Out] PROPVARIANT pValue);
} }
/// <summary> /// <summary>