Compartir a través de

Referencia de la API no administrada de ClickOnce

  • Artículo

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).

Consulte también