Condividi tramite

Riferimenti alle API non gestite ClickOnce

  • Articolo

API pubbliche non gestite clickOnce da dfshim.dll.

CleanOnlineAppCache

Pulisce o disinstalla tutte le applicazioni online dalla cache dell'applicazione ClickOnce.

Valore restituito

Se ha esito positivo, restituisce S_OK; in caso contrario, restituisce un valore HRESULT che rappresenta l'errore. Se si verifica un'eccezione gestita, restituisce 0x80020009 (DISP_E_EXCEPTION).

Osservazioni:

Se non è già in esecuzione, la chiamata a CleanOnlineAppCache avvierà il servizio ClickOnce.

GetDeploymentDataFromManifest

Recupera le informazioni di distribuzione dal manifesto e dall'URL di attivazione.

Parametri

Parametro Descrizione Tipo
pcwzActivationUrl Puntatore a ActivationURL. LPCWSTR
pcwzPathToDeploymentManifest Puntatore a PathToDeploymentManifest. LPCWSTR
pwzApplicationIdentity Puntatore a un buffer per ricevere una stringa con terminazione NULL che specifica l'identità dell'applicazione completa restituita. LPWSTR
pdwIdentityBufferLength Puntatore a un DWORD che rappresenta la lunghezza del pwzApplicationIdentity buffer, in WCHAR. Include lo spazio per il carattere di terminazione NULL. LPDWORD
pwzProcessorArchitecture Puntatore a un buffer per ricevere una stringa con terminazione NULL che specifica l'architettura del processore della distribuzione dell'applicazione dal manifesto. LPWSTR
pdwArchitectureBufferLength Puntatore a un DWORD che rappresenta la lunghezza del pwzProcessorArchitecture buffer, in WCHAR. LPDWORD
pwzApplicationManifestCodebase Puntatore a un buffer per ricevere una stringa con terminazione NULL che specifica la codebase del manifesto dell'applicazione dal manifesto dell'applicazione. LPWSTR
pdwCodebaseBufferLength Puntatore a un DWORD che rappresenta la lunghezza del pwzApplicationManifestCodebase buffer, in WCHAR. LPDWORD
pwzDeploymentProvider Puntatore a un buffer per ricevere una stringa con terminazione NULL che specifica il provider di distribuzione dal manifesto, se presente. In caso contrario, viene restituita una stringa vuota. LPWSTR
pdwProviderBufferLength Puntatore a un DWORD che corrisponde alla lunghezza dell'oggetto pwzProviderBufferLength. LPDWORD

Valore restituito

Se ha esito positivo, restituisce S_OK; in caso contrario, restituisce un valore HRESULT che rappresenta l'errore. Restituisce HRESULTFROMWIN32(ERROR_INSUFFICIENT_BUFFER) se un buffer è troppo piccolo.

Osservazioni:

I puntatori non devono essere Null. pcwzActivationUrl e pcwzPathToDeploymentManifest non devono essere vuoti.

È responsabilità del chiamante pulire l'URL di attivazione. Ad esempio, l'aggiunta di caratteri di escape in cui sono necessari o la rimozione della stringa di query.

È responsabilità del chiamante limitare la lunghezza dell'input. Ad esempio, la lunghezza massima dell'URL è di 2 KB.

LaunchApplication

Avvia o installa un'applicazione usando un URL di distribuzione.

Parametri

Parametro Descrizione Tipo
deploymentUrl Puntatore a una stringa con terminazione NULL contenente l'URL del manifesto della distribuzione. LPCWSTR
data Riservato a un uso futuro. Deve essere NULL. LPVOID
flags Riservato a un uso futuro. Deve essere 0. DWORD

Valore restituito

Se ha esito positivo, restituisce S_OK; in caso contrario, restituisce un valore HRESULT che rappresenta l'errore. Se si verifica un'eccezione gestita, restituisce 0x80020009 (DISP_E_EXCEPTION).

Vedi anche