ClickOnce 非受控 API 參考
dfshim.dll 中的 ClickOnce 非受控公用 API。
CleanOnlineAppCache
從 ClickOnce 應用程式快取清除或解除安裝所有線上應用程式。
傳回值
如果成功，則會傳回 S_OK；否則傳回代表失敗的 HRESULT。 如果發生受控例外狀況，則會傳回 0x80020009 (DISP_E_EXCEPTION)。
備註
如果 ClickOnce 服務尚未執行，則呼叫 CleanOnlineAppCache 會啟動該服務。
GetDeploymentDataFromManifest
從資訊清單和啟用 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。
LaunchApplication
使用部署 URL 來啟動或安裝應用程式。
參數
| 參數 | 描述 | 類型 |
|---|---|---|
deploymentUrl |
N以 Null 結束的字串指標，該字串包含部署資訊清單的 URL。 | LPCWSTR |
data |
保留供未來使用。 必須是 Null。 | LPVOID |
flags |
保留供未來使用。 必須是 0。 | 下載 |
傳回值
如果成功，則會傳回 S_OK；否則傳回代表失敗的 HRESULT。 如果發生受控例外狀況，則會傳回 0x80020009 (DISP_E_EXCEPTION)。