shellapi.h 标头

此标头由多种技术使用。 有关详细信息，请参阅：

• Windows Shell
• Windows 属性系统

shellapi.h 包含以下编程接口：

函数

AssocCreateForClasses 检索实现 IQueryAssociations 接口的对象。
CommandLineToArgvW 分析 Unicode 命令行字符串，并返回指向命令行参数的指针数组，以及此类参数的计数，其方式类似于标准 C 运行时 argv 和 argc 值。
DoEnvironmentSubstA 分析包含对一个或多个环境变量的引用的输入字符串，并将其替换为其完全扩展的值。 (ANSI)
DoEnvironmentSubstW 分析包含对一个或多个环境变量的引用的输入字符串，并将其替换为其完全扩展的值。 (Unicode)
DragAcceptFiles 注册窗口是否接受已删除的文件。
DragFinish 释放系统分配用于将文件名传输到应用程序的内存。
DragQueryFileA 检索由成功拖放操作生成的已删除文件的名称。 (ANSI)
DragQueryFileW 检索由成功拖放操作生成的已删除文件的名称。 (Unicode)
DragQueryPoint 检索在拖放操作期间放置文件时鼠标指针的位置。
DuplicateIcon 创建指定图标的副本。
ExtractAssociatedIconA 获取作为资源存储在文件中的图标或存储在文件的关联可执行文件中的图标的句柄。 (ANSI)
ExtractAssociatedIconExA ExtractAssociatedIconEx 可能已更改或不可用。 (ANSI)
ExtractAssociatedIconExW ExtractAssociatedIconEx 可能已更改或不可用。 (Unicode)
ExtractAssociatedIconW 获取作为资源存储在文件中的图标或存储在文件的关联可执行文件中的图标的句柄。 (Unicode)
ExtractIconA 从指定的可执行文件、DLL 或图标文件中获取图标的句柄。 若要检索大图标或小图标的句柄数组，请使用 ExtractIconEx 函数。 (ANSI)
ExtractIconExA ExtractIconEx 函数创建从指定可执行文件、DLL 或图标文件中提取的大图标或小图标的句柄数组。 (ANSI)
ExtractIconExW ExtractIconEx 函数创建从指定可执行文件、DLL 或图标文件中提取的大图标或小图标的句柄数组。 (Unicode)
ExtractIconW 从指定的可执行文件、DLL 或图标文件中获取图标的句柄。 若要检索大图标或小图标的句柄数组，请使用 ExtractIconEx 函数。 (Unicode)
FindExecutableA 检索与特定文档文件关联的可执行 (.exe) 文件的名称和句柄。 (ANSI)
FindExecutableW 检索与特定文档文件关联的可执行 (.exe) 文件的名称和句柄。 (Unicode)
InitNetworkAddressControl 初始化网络地址控制窗口类。
NetAddr_DisplayErrorTip 在与网络地址控件关联的气球提示中显示错误消息。
NetAddr_GetAddress 指示网络地址是否符合指定的类型和格式。
NetAddr_GetAllowType 检索指定网络地址控件接受的网络地址类型。
NetAddr_SetAllowType 设置指定网络地址控件接受的网络地址类型。
SHAppBarMessage 向系统发送应用栏消息。
SHCreateProcessAsUserW 创建新的用户模式进程及其主线程以运行指定的可执行文件。
Shell_NotifyIconA 将消息发送到任务栏的状态区域。 (ANSI)
Shell_NotifyIconGetRect 获取通知图标的边框的屏幕坐标。
Shell_NotifyIconW 将消息发送到任务栏的状态区域。 (Unicode)
ShellAboutA 显示 Shell About 对话框。 (ANSI)
ShellAboutW 显示 Shell About 对话框。 (Unicode)
ShellExecuteA 对指定的文件执行操作。 (ShellExecuteA)
ShellExecuteExA 对指定的文件执行操作。 (ShellExecuteExA)
ShellExecuteExW 对指定的文件执行操作。 (ShellExecuteExW)
ShellExecuteW 对指定的文件执行操作。 (ShellExecuteW)
ShellMessageBoxA ShellMessageBox 可能已更改或不可用。 (ANSI)
ShellMessageBoxW ShellMessageBox 可能已更改或不可用。 (Unicode)
SHEmptyRecycleBinA 清空指定驱动器上的回收站。 (ANSI)
SHEmptyRecycleBinW 清空指定驱动器上的回收站。 (Unicode)
SHEnumerateUnreadMailAccountsA 枚举具有未读电子邮件的用户帐户。 (ANSI)
SHEnumerateUnreadMailAccountsW 枚举具有未读电子邮件的用户帐户。 (Unicode)
SHEvaluateSystemCommandTemplate 强制对调用 CreateProcess 或 ShellExecute 中使用的参数进行严格验证。
SHFileOperationA 复制、移动、重命名或删除文件系统对象。 此函数已在 Windows Vista 中替换为 IFileOperation。
SHFileOperationW 复制、移动、重命名或删除文件系统对象。 在 Windows Vista 及更高版本中，建议使用 IFileOperation 而不是此函数。
SHFreeNameMappings 释放由 SHFileOperation 函数检索的文件名映射对象。
SHGetDiskFreeSpaceExA 检索磁盘卷的磁盘空间信息。 (ANSI)
SHGetDiskFreeSpaceExW 检索磁盘卷的磁盘空间信息。 (Unicode)
SHGetDriveMedia 返回给定驱动器中的媒体类型。
SHGetFileInfoA 检索有关文件系统中的对象的信息，例如文件、文件夹、目录或驱动器根目录。 (ANSI)
SHGetFileInfoW 检索有关文件系统中的对象的信息，例如文件、文件夹、目录或驱动器根目录。 (Unicode)
SHGetImageList 检索图像列表。
SHGetLocalizedName 检索 Shell 文件夹中文件的本地化名称。
SHGetNewLinkInfoA 基于快捷方式的建议目标为新快捷方式创建一个名称。 此函数不会创建快捷方式，而只会创建名称。 (ANSI)
SHGetNewLinkInfoW 基于快捷方式的建议目标为新快捷方式创建一个名称。 此函数不会创建快捷方式，而只会创建名称。 (Unicode)
SHGetPropertyStoreForWindow 检索表示特定窗口的属性集合的对象，该集合允许查询或设置这些属性。
SHGetStockIconInfo 检索有关系统定义的 Shell 图标的信息。
SHGetUnreadMailCountA 检索任何或所有电子邮件帐户的指定用户的未读邮件计数。 (ANSI)
SHGetUnreadMailCountW 检索任何或所有电子邮件帐户的指定用户的未读邮件计数。 (Unicode)
SHInvokePrinterCommandA 对打印机对象执行命令。 (ANSI)
SHInvokePrinterCommandW 对打印机对象执行命令。 (Unicode)
SHIsFileAvailableOffline 确定文件或文件夹是否可供脱机使用。 此函数还确定是从网络、本地脱机文件缓存还是从这两个位置打开文件。
SHLoadNonloadedIconOverlayIdentifiers 向 Shell 发出信号，在需要覆盖信息的下一个操作中，它应加载创建失败或在启动时不存在的图标覆盖标识符。 已加载的标识符不受影响。
SHQueryRecycleBinA 检索指定驱动器的回收站的大小以及其中的项目数。 (ANSI)
SHQueryRecycleBinW 检索指定驱动器的回收站的大小以及其中的项目数。 (Unicode)
SHQueryUserNotificationState 检查当前用户的计算机状态，以确定发送通知是否合适。
SHRemoveLocalizedName 删除 Shell 文件夹中文件的本地化名称。
SHSetLocalizedName 设置 Shell 文件夹中文件的本地化名称。
SHSetUnreadMailCountA 存储注册表中指定电子邮件帐户的当前用户未读邮件计数。 (ANSI)
SHSetUnreadMailCountW 存储注册表中指定电子邮件帐户的当前用户未读邮件计数。 (Unicode)
SHTestTokenMembership 使用 CheckTokenMembership 测试给定令牌是否是具有指定 RID 的本地组的成员。

结构

APPBARDATA 包含有关系统应用栏消息的信息。
ASSOCIATIONELEMENT 定义 AssocCreateForClasses 用于检索给定文件关联的 IQueryAssociations 接口的信息。
NC_ADDRESS 包含描述网络地址的信息。
NOTIFYICONDATAA 包含系统在通知区域中显示通知所需的信息。 由 Shell_NotifyIcon 使用。 (ANSI)
NOTIFYICONDATAW 包含系统在通知区域中显示通知所需的信息。 由 Shell_NotifyIcon 使用。 (Unicode)
NOTIFYICONIDENTIFIER 包含Shell_NotifyIconGetRect用于标识要为其检索边框的图标的信息。
OPEN_PRINTER_PROPS_INFOA 标识打印机属性页中的特定属性表，以及该属性表是否应为模式。 （可选）与 SHInvokePrinterCommand 函数一起使用。 (ANSI)
OPEN_PRINTER_PROPS_INFOW 标识打印机属性页中的特定属性表，以及该属性表是否应为模式。 （可选）与 SHInvokePrinterCommand 函数一起使用。 (Unicode)
SHCREATEPROCESSINFOW 包含 SHCreateProcessAsUserW 创建进程所需的信息。
SHELLEXECUTEINFOA 包含 ShellExecuteEx 使用的信息。 (ANSI)
SHELLEXECUTEINFOW 包含 ShellExecuteEx 使用的信息。 (Unicode)
SHFILEINFOA 包含有关文件对象的信息。 (ANSI)
SHFILEINFOW 包含有关文件对象的信息。 (Unicode)
SHFILEOPSTRUCTA 包含 SHFileOperation 函数用于执行文件操作的信息。 (ANSI)
SHFILEOPSTRUCTW 包含 SHFileOperation 函数用于执行文件操作的信息。 (Unicode)
SHNAMEMAPPINGA 包含由 SHFileOperation 函数移动、复制或重命名的每个文件的旧路径名和新路径名。 (ANSI)
SHNAMEMAPPINGW 包含由 SHFileOperation 函数移动、复制或重命名的每个文件的旧路径名和新路径名。 (Unicode)
SHQUERYRBINFO 包含 SHQueryRecycleBin 函数检索的大小和项计数信息。
SHSTOCKICONINFO 接收用于检索常用 Shell 图标的信息。 此结构用于调用 SHGetStockIconInfo。

枚举

QUERY_USER_NOTIFICATION_STATE 指定当前用户的计算机状态（相对于发送通知的礼仪）。 由 SHQueryUserNotificationState 使用。
SHSTOCKICONID 由 SHGetStockIconInfo 用来标识要检索的股票系统图标。