ClickOnce Unmanaged API 參考

來自 dfshim.dll 的 ClickOnce Unmanaged 公用 API。

CleanOnlineAppCache

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

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

呼叫 CleanOnlineAppCache 將會啟動 ClickOnce 服務 (如果它尚未執行)。

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

參數	描述	型別
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 啟動或安裝應用程式。

參數	描述	型別
deploymentUrl	NULL 結尾字串的指標，該字串包含部署資訊清單的 URL。	LPCWSTR
data	保留供將來使用。必須為 NULL。	LPVOID
flags	保留供將來使用。必須為 0。	DWORD

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