Referência de API não gerenciada do ClickOnce
APIs públicas não gerenciadas do ClickOnce de dfshim.dll.
CleanOnlineAppCache
Limpa ou desinstala todos os aplicativos online do cache do aplicativo ClickOnce.
Retornar valor
Se tiver êxito, retornará S_OK; caso contrário, retornará um HRESULT que representa a falha. Se ocorrer uma exceção gerenciada, retornará 0x80020009 (DISP_E_EXCEPTION).
Comentários
O chamamento de CleanOnlineAppCache iniciará o serviço ClickOnce se ele ainda não estiver em execução.
GetDeploymentDataFromManifest
Recupera informações de implantação da URL de manifesto e ativação.
Parâmetros
| Parâmetro | Descrição | Type |
|---|---|---|
pcwzActivationUrl |
Um ponteiro para o ActivationURL. |
LPCWSTR |
pcwzPathToDeploymentManifest |
Um ponteiro para o PathToDeploymentManifest. |
LPCWSTR |
pwzApplicationIdentity |
Um ponteiro para um buffer a fim de receber uma cadeia de caracteres terminada por NULL que especifica a identidade completa do aplicativo retornada. | LPWSTR |
pdwIdentityBufferLength |
Um ponteiro para um DWORD que é o tamanho do buffer pwzApplicationIdentity, em WCHARs. Isso inclui o espaço para o caractere de terminação NULL. |
LPDWORD |
pwzProcessorArchitecture |
Um ponteiro para um buffer a fim de receber uma cadeia de caracteres terminada por NULL que especifica a arquitetura do processador da implantação do aplicativo vindo do manifesto. | LPWSTR |
pdwArchitectureBufferLength |
Um ponteiro para um DWORD que é o tamanho do buffer pwzProcessorArchitecture, em WCHARs. |
LPDWORD |
pwzApplicationManifestCodebase |
Um ponteiro para um buffer a fim de receber uma cadeia de caracteres terminada por NULL que especifica a base de código do manifesto do aplicativo vinda do manifesto. | LPWSTR |
pdwCodebaseBufferLength |
Um ponteiro para um DWORD que é o tamanho do buffer pwzApplicationManifestCodebase, em WCHARs. |
LPDWORD |
pwzDeploymentProvider |
Um ponteiro para um buffer para receber uma cadeia de caracteres terminada por NULL que especifica o provedor de implantação do manifesto, caso esteja presente. Caso contrário, uma cadeia de caracteres vazia será retornada. | LPWSTR |
pdwProviderBufferLength |
Um ponteiro para um DWORD que tem o tamanho de pwzProviderBufferLength. |
LPDWORD |
Retornar valor
Se tiver êxito, retornará S_OK; caso contrário, retornará um HRESULT que representa a falha. Retornará HRESULTFROMWIN32(ERROR_INSUFFICIENT_BUFFER) se um buffer for muito pequeno.
Comentários
Os ponteiros não podem ser nulos. pcwzActivationUrl e pcwzPathToDeploymentManifest não podem estar vazios.
É responsabilidade do chamador limpar a URL de ativação. Por exemplo, adicionando caracteres de escape onde eles são necessários ou removendo a cadeia de caracteres de consulta.
É responsabilidade do chamador limitar o tamanho da entrada. Por exemplo, o tamanho máximo da URL é de 2 KB.
LaunchApplication
Inicia ou instala um aplicativo usando uma URL de implantação.
Parâmetros
| Parâmetro | Descrição | Type |
|---|---|---|
deploymentUrl |
Um ponteiro para uma cadeia de caracteres terminada em NULL que contém a URL do manifesto de implantação. | LPCWSTR |
data |
Reservado para uso futuro. Precisa ser NULL. | LPVOID |
flags |
Reservado para uso futuro. Deve ser 0. | DWORD |
Retornar valor
Se tiver êxito, retornará S_OK; caso contrário, retornará um HRESULT que representa a falha. Se ocorrer uma exceção gerenciada, retornará 0x80020009 (DISP_E_EXCEPTION).