ClickOnce Yönetilmeyen API Başvurusu
dfshim.dll'den ClickOnce yönetilmeyen ortak API'leri.
CleanOnlineAppCache
ClickOnce uygulaması önbelleğinden tüm çevrimiçi uygulamaları temizler ve kaldırır.
Dönüş Değeri
Başarılı olursa, S_OK verir; aksi durumda, başarısızlık anlamına gelen bir HRESULT verir. Yönetilen bir özel durum oluşursa, 0x80020009 (DISP_E_EXCEPTION) döndürür.
Notlar
CleanOnlineAppCache çağırma ClickOnce hizmetini, zaten çalışmıyorsa, başlatır.
GetDeploymentDataFromManifest
Bildirim ve etkinleştirme URL'sinden dağıtım bilgisini alır.
Parametreler
Parametre |
Description |
Tür |
---|---|---|
pcwzActivationUrl |
ActivationURL işaretçisi |
LPCWSTR |
pcwzPathToDeploymentManifest |
PathToDeploymentManifest işaretçisi |
LPCWSTR |
pwzApplicationIdentity |
Verilmiş tam uygulama kimliğini belirten NULL sonlandırılmış bir dize almak üzere arabellek için bir işaretçi. |
LPWSTR |
pdwIdentityBufferLength |
pwzApplicationIdentity arabelleğinin WCHAR'lar içinde uzunluğu olan DWORD için bir işaretçi. Bu, NULL sonlandırma karakteri için boşluk içerir. |
LPDWORD |
pwzProcessorArchitecture |
Bildirimden uygulama dağıtımının işlemci mimarisini belirten NULL sonlandırılmış bir dize almak üzere arabellek için bir işaretçi |
LPWSTR |
pdwArchitectureBufferLength |
pwzProcessorArchitecture arabelleğinin WCHAR'lar içinde uzunluğu olan DWORD için bir işaretçi. |
LPDWORD |
pwzApplicationManifestCodebase |
Bildirimden uygulama bildiriminin kod temelini (codebase) belirten NULL sonlandırılmış bir dize almak üzere arabellek için bir işaretçi. |
LPWSTR |
pdwCodebaseBufferLength |
pwzApplicationManifestCodebase arabelleğinin WCHAR'lar içinde uzunluğu olan DWORD için bir işaretçi. |
LPDWORD |
pwzDeploymentProvider |
Mevcutsa, bildirimden dağıtım sağlayıcıyı belirten NULL sonlandırılmış dizeyi almak üzere arabellek için bir işaretçi. Aksi halde, boş bir dize döndürülür. |
LPWSTR |
pdwProviderBufferLength |
pwzProviderBufferLength'in uzunluğu olan DWORD için bir işaretçi. |
LPDWORD |
Dönüş Değeri
Başarılı olursa, S_OK verir; aksi durumda, başarısızlık anlamına gelen bir HRESULT verir. Arbellek çok küçükse, HRESULTFROMWIN32(ERROR_INSUFFICIENT_BUFFER) döner.
Notlar
İşaretçiler null olmamalıdır. pcwzActivationUrl ve pcwzPathToDeploymentManifest boş olmamalıdır.
Etkinleştirme URL'sini temizlemek çağırıcının (caller) sorumluluğundadır. Örneğin, gereken yerlere kaçış karakterleri ekleme veya sorgu dizesini kaldırma.
Giriş uzunluğunu sınırlamak çağırıcının sorumluluğundadır. Örneğin, URL uzunluğu en fazla 2 KB olabilir.
LaunchApplication
Dağıtım URL'si kullanarak bir uygulamayı başlatır ve yükler.
Parametreler
Parametre |
Description |
Tür |
---|---|---|
deploymentUrl |
Dağıtım bildiriminin URL'sini içeren NULL sonlandırılmış dize için bir işaretçi. |
LPCWSTR |
data |
İleride kullanılmak üzere ayrılmıştır. NULL olmalıdır. |
LPVOID |
flags |
İleride kullanılmak üzere ayrılmıştır. 0 olmalıdır. |
DWORD |
Dönüş Değeri
Başarılı olursa, S_OK verir; aksi durumda, başarısızlık anlamına gelen bir HRESULT verir. Yönetilen bir özel durum oluşursa, 0x80020009 (DISP_E_EXCEPTION) döndürür.