CF_PIN_STATE 枚举 (cfapi.h)

占位符文件或目录的固定状态。

语法

typedef enum CF_PIN_STATE {
  CF_PIN_STATE_UNSPECIFIED = 0,
  CF_PIN_STATE_PINNED = 1,
  CF_PIN_STATE_UNPINNED = 2,
  CF_PIN_STATE_EXCLUDED = 3,
  CF_PIN_STATE_INHERIT = 4
} ;

常量

CF_PIN_STATE_UNSPECIFIED 值： 0 平台可以自由决定占位符的内容何时需要在磁盘本地显示或不存在。
CF_PIN_STATE_PINNED 值：1 在平台收到固定请求后，同步提供程序将收到异步提取占位符内容的通知。 无法保证在 CfSetPinState 调用成功完成后，要固定的占位符将在本地完全可用。 但是，平台将在固定占位符上失败任何冻结请求。
CF_PIN_STATE_UNPINNED 值： 2 平台收到取消固定请求后，将通知同步提供程序异步解除冻结/使占位符在磁盘上的内容失效。 无法保证在 API 调用成功完成后，要取消固定的占位符将完全冻结。
CF_PIN_STATE_EXCLUDED 值： 3 同步提供程序永远不会将占位符同步到云。 此状态只能由同步提供程序设置。
CF_PIN_STATE_INHERIT 值： 4 平台将其视为调用方对占位符执行移动操作，因此根据其父级的固定状态重新评估占位符的固定状态。 有关继承表 ，请参阅“备注 ”部分。

注解

	Parent	未指定	Pinned	取消固定	已排除
文件	未指定	未指定	Pinned	未指定	已排除
	Pinned	Pinned	Pinned	Pinned	已排除
	取消固定	取消固定	取消固定	取消固定	已排除
	已排除	未指定	Pinned	未指定	已排除
Directory	未指定	未指定	Pinned	取消固定	已排除
	Pinned	Pinned	Pinned	Pinned	已排除
	取消固定	取消固定	取消固定	取消固定	已排除
	已排除	未指定	Pinned	取消固定	已排除

要求

要求	值
最低受支持的客户端	Windows 10版本 1709 [仅限桌面应用]
最低受支持的服务器	Windows Server 2016 [仅限桌面应用]
标头	cfapi.h

另请参阅

CfSetPinState