Riferimenti alle API non gestite ClickOnce
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).