ClickOnce 非受控 API 參考

dfshim.dll 中的 ClickOnce 非受控公用 API。

CleanOnlineAppCache

從 ClickOnce 應用程式快取清除或解除安裝所有線上應用程式。

如果成功，則會傳回 S_OK；否則傳回代表失敗的 HRESULT。如果發生受控例外狀況，則會傳回 0x80020009 (DISP_E_EXCEPTION)。

如果 ClickOnce 服務尚未執行，則呼叫 CleanOnlineAppCache 會啟動該服務。

從資訊清單和啟用 URL 擷取部署資訊。

參數	描述	類型
`pcwzActivationUrl`	`ActivationURL` 的指標。	LPCWSTR
`pcwzPathToDeploymentManifest`	`PathToDeploymentManifest` 的指標。	LPCWSTR
`pwzApplicationIdentity`	緩衝區的指標，用以接收以 Null 結束的字串，該字串指定傳回的完整應用程式識別。	LPWSTR
`pdwIdentityBufferLength`	DWORD 的指標，這是 `pwzApplicationIdentity` 緩衝區的長度 (以 WCHAR 為單位)。這包含 Null 終止字元的空間。	LPDWORD
`pwzProcessorArchitecture`	緩衝區的指標，用以接收資訊清單中以 Null 結束的字串，該字串指定應用程式部署的處理器架構。	LPWSTR
`pdwArchitectureBufferLength`	DWORD 的指標，這是 `pwzProcessorArchitecture` 緩衝區的長度 (以 WCHAR 為單位)。	LPDWORD
`pwzApplicationManifestCodebase`	緩衝區的指標，用以接收資訊清單中以 Null 結束的字串，該字串指定應用程式資訊清單的程式碼基底。	LPWSTR
`pdwCodebaseBufferLength`	DWORD 的指標，這是 `pwzApplicationManifestCodebase` 緩衝區的長度 (以 WCHAR 為單位)。	LPDWORD
`pwzDeploymentProvider`	緩衝區的指標，用以接收資訊清單中以 Null 結束的字串，該字串指定部署提供者。否則會傳回空字串。	LPWSTR
`pdwProviderBufferLength`	DWORD 的指標，這是 `pwzProviderBufferLength` 的長度。	LPDWORD

如果成功，則會傳回 S_OK；否則傳回代表失敗的 HRESULT。如果緩衝區太小，則傳回 HRESULTFROMWIN32(ERROR_INSUFFICIENT_BUFFER)。

指標不得為 NULL。 pcwzActivationUrl 和 pcwzPathToDeploymentManifest 不可為空白。

呼叫者有責任清除啟用 URL。例如，新增所需的逸出字元，或移除查詢字串。

呼叫端有責任限制輸入長度。例如，URL 長度上限為 2KB。

使用部署 URL 來啟動或安裝應用程式。

參數	描述	類型
`deploymentUrl`	N以 Null 結束的字串指標，該字串包含部署資訊清單的 URL。	LPCWSTR
`data`	保留供未來使用。必須是 Null。	LPVOID
`flags`	保留供未來使用。必須是 0。	下載

如果成功，則會傳回 S_OK；否則傳回代表失敗的 HRESULT。如果發生受控例外狀況，則會傳回 0x80020009 (DISP_E_EXCEPTION)。