Referencia de la API no administrada de ClickOnce
API públicas no administradas de ClickOnce de dfshim.dll.
CleanOnlineAppCache
Limpia o desinstala todas las aplicaciones en línea de la caché de aplicaciones ClickOnce.
Valor devuelto
Si se ejecuta correctamente, devuelve S_OK; de lo contrario, devuelve un valor HRESULT que representa el error. Si se produce una excepción administrada, devuelve 0x80020009 (DISP_E_EXCEPTION).
Comentarios
Al llamar a CleanOnlineAppCache, se iniciará el servicio ClickOnce si aún no se está ejecutando.
GetDeploymentDataFromManifest
Recupera información de implementación del manifiesto y la dirección URL de activación.
Parámetros
| Parámetro | Descripción | Tipo |
|---|---|---|
pcwzActivationUrl |
Puntero a ActivationURL. |
LPCWSTR |
pcwzPathToDeploymentManifest |
Puntero a PathToDeploymentManifest. |
LPCWSTR |
pwzApplicationIdentity |
Puntero a un búfer para recibir una cadena terminada en NULL que especifica la identidad de aplicación completa devuelta. | LPWSTR |
pdwIdentityBufferLength |
Puntero a un DWORD que es la longitud del búfer pwzApplicationIdentity, en WCHAR. Incluye el espacio para el carácter de terminación NULL. |
LPDWORD |
pwzProcessorArchitecture |
Puntero a un búfer para recibir una cadena terminada en NULL que especifica la arquitectura del procesador de la implementación de la aplicación, desde el manifiesto. | LPWSTR |
pdwArchitectureBufferLength |
Puntero a un DWORD que es la longitud del búfer pwzProcessorArchitecture, en WCHAR. |
LPDWORD |
pwzApplicationManifestCodebase |
Puntero a un búfer para recibir una cadena terminada en NULL que especifica el código base del manifiesto de aplicación, desde el manifiesto. | LPWSTR |
pdwCodebaseBufferLength |
Puntero a un DWORD que es la longitud del búfer pwzApplicationManifestCodebase, en WCHAR. |
LPDWORD |
pwzDeploymentProvider |
Puntero a un búfer para recibir una cadena terminada en NULL que especifica el proveedor de implementación desde el manifiesto, si existe. De lo contrario, se devuelve una cadena vacía. | LPWSTR |
pdwProviderBufferLength |
Puntero a un DWORD que es la longitud de pwzProviderBufferLength. |
LPDWORD |
Valor devuelto
Si se ejecuta correctamente, devuelve S_OK; de lo contrario, devuelve un valor HRESULT que representa el error. Devuelve HRESULTFROMWIN32(ERROR_INSUFFICIENT_BUFFER) si un búfer es demasiado pequeño.
Comentarios
Los punteros no deben ser NULL. pcwzActivationUrl y pcwzPathToDeploymentManifest no deben estar vacíos.
Es responsabilidad del autor de la llamada limpiar la dirección URL de activación. Por ejemplo, agregar caracteres de escape donde se necesiten o quitar la cadena de consulta.
Es responsabilidad del autor de la llamada limitar la longitud de entrada. Por ejemplo, la longitud máxima de la dirección URL es de 2 KB.
LaunchApplication
Inicia o instala una aplicación mediante una dirección URL de implementación.
Parámetros
| Parámetro | Descripción | Tipo |
|---|---|---|
deploymentUrl |
Puntero a una cadena terminada en NULL que contiene la dirección URL del manifiesto de implementación. | LPCWSTR |
data |
Reservado para uso futuro. Debe ser NULL. | LPVOID |
flags |
Reservado para uso futuro. Debe ser 0. | DWORD |
Valor devuelto
Si se ejecuta correctamente, devuelve S_OK; de lo contrario, devuelve un valor HRESULT que representa el error. Si se produce una excepción administrada, devuelve 0x80020009 (DISP_E_EXCEPTION).