ClickOnce 非托管 API 参考

来自 dfshim.dll 的 ClickOnce 非托管公共 API。

CleanOnlineAppCache

从 ClickOnce 应用程序缓存中清理或卸载所有的联机应用程序。

如果成功，则返回 S_OK；否则，将返回表示失败的 HRESULT。如果发生托管异常，则返回 0x80020009 (DISP_E_EXCEPTION)。

如果 ClickOnce 服务尚未运行，则调用 CleanOnlineAppCache 将启动该服务。

从清单和激活 URL 中检索部署信息。

Parameter	说明	类型
pcwzActivationUrl	指向 ActivationURL 的指针。	LPCWSTR
pcwzPathToDeploymentManifest	指向 PathToDeploymentManifest 的指针。	LPCWSTR
pwzApplicationIdentity	一个指向接收以 NULL 结尾的字符串的缓冲区的指针，该字符串指定返回的完整应用程序标识。	LPWSTR
pdwIdentityBufferLength	一个指向 DWORD 的指针，DWORD 表示 pwzApplicationIdentity 缓冲区的长度，以 WCHAR 为单位。其中包括用于 NULL 终止字符的空格。	LPDWORD
pwzProcessorArchitecture	一个指向接收以 NULL 结尾的字符串的缓冲区的指针，该字符串指定清单中的应用程序部署的处理器体系结构。	LPWSTR
pdwArchitectureBufferLength	一个指向 DWORD 的指针，DWORD 表示 pwzProcessorArchitecture 缓冲区的长度，以 WCHAR 为单位。	LPDWORD
pwzApplicationManifestCodebase	一个指向接收以 NULL 结尾的字符串的缓冲区的指针，该字符串指定清单中的应用程序清单的基本代码。	LPWSTR
pdwCodebaseBufferLength	一个指向 DWORD 的指针，DWORD 表示 pwzApplicationManifestCodebase 缓冲区的长度，以 WCHAR 为单位。	LPDWORD
pwzDeploymentProvider	一个指向接收以 NULL 结尾的字符串的缓冲区的指针，该字符串指定清单中的部署提供程序（如果存在）。如果不存在，则将返回一个空字符串。	LPWSTR
pdwProviderBufferLength	一个指向 DWORD 的指针，DWORD 表示 pwzProviderBufferLength 的长度。	LPDWORD

如果成功，则返回 S_OK；否则，将返回表示失败的 HRESULT。如果缓冲区太小，则返回 HRESULTFROMWIN32(ERROR_INSUFFICIENT_BUFFER)。

指针不得为 null。pcwzActivationUrl 和 pcwzPathToDeploymentManifest 不得为空。

调用方负责清理激活 URL。例如，在需要时添加转义符或移除查询字符串。

调用方负责限制输入长度。例如，最大 URL 长度为 2KB。

通过使用部署 URL 来启动或安装应用程序。

Parameter	说明	类型
deploymentUrl	一个指向以 NULL 结尾的字符串的指针，该字符串包含部署清单的 URL。	LPCWSTR
data	保留供将来使用。必须为 NULL。	LPVOID
flags	保留供将来使用。必须为 0。	DWORD

如果成功，则返回 S_OK；否则，将返回表示失败的 HRESULT。如果发生托管异常，则返回 0x80020009 (DISP_E_EXCEPTION)。