ClickOnce yönetilmeyen API başvurusu
ClickOnce dfshim.dll dosyasından yönetilmeyen genel API'ler.
CleanOnlineAppCache
ClickOnce uygulama önbelleğindeki tüm çevrimiçi uygulamaları temizler veya kaldırır.
Dönüş değeri
Başarılı olursa, S_OK döndürür; aksi takdirde, hatayı temsil eden bir HRESULT döndürür. Yönetilen bir özel durum oluşursa, 0x80020009 (DISP_E_EXCEPTION) döndürür.
Açıklamalar
CleanOnlineAppCache çağrısı, henüz çalışmıyorsa ClickOnce hizmetini başlatır.
GetDeploymentDataFromManifest
Bildirim ve etkinleştirme URL'sinden dağıtım bilgilerini alır.
Parametreler
| Parametre | Açıklama | Türü |
|---|---|---|
pcwzActivationUrl |
öğesine işaret eden bir ActivationURLişaretçi. |
LPCWSTR |
pcwzPathToDeploymentManifest |
öğesine işaret eden bir PathToDeploymentManifestişaretçi. |
LPCWSTR |
pwzApplicationIdentity |
Döndürülen tam uygulama kimliğini belirten NULL ile sonlandırılan bir dizeyi almak için arabelleğe yönelik bir işaretçi. | LPWSTR |
pdwIdentityBufferLength |
WCHAR'larda arabelleğin pwzApplicationIdentity uzunluğu olan bir DWORD işaretçisi. Buna NULL sonlandırma karakteri için boşluk da dahildir. |
LPDWORD |
pwzProcessorArchitecture |
Bildirimden uygulama dağıtımının işlemci mimarisini belirten NULL ile sonlandırılan bir dizeyi almak için arabelleğe yönelik bir işaretçi. | LPWSTR |
pdwArchitectureBufferLength |
WCHAR'larda arabelleğin pwzProcessorArchitecture uzunluğu olan bir DWORD işaretçisi. |
LPDWORD |
pwzApplicationManifestCodebase |
Bildirimden uygulama bildiriminin kod tabanını belirten NULL ile sonlandırılan bir dizeyi almak için arabelleğe yönelik bir işaretçi. | LPWSTR |
pdwCodebaseBufferLength |
WCHAR'larda arabelleğin pwzApplicationManifestCodebase uzunluğu olan bir DWORD işaretçisi. |
LPDWORD |
pwzDeploymentProvider |
Varsa bildirimden dağıtım sağlayıcısını belirten NULL ile sonlandırılan bir dize almak için arabelleğe yönelik bir işaretçi. Aksi takdirde, boş bir dize döndürülür. | LPWSTR |
pdwProviderBufferLength |
DWORD'ün uzunluğuna pwzProviderBufferLengthişaret eden bir işaretçi. |
LPDWORD |
Dönüş değeri
Başarılı olursa, S_OK döndürür; aksi takdirde, hatayı temsil eden bir HRESULT döndürür. Arabellek çok küçükse HRESULTFROMWIN32(ERROR_INSUFFICIENT_BUFFER) döndürür.
Açıklamalar
İşaretçiler null olmamalıdır. pcwzActivationUrl ve pcwzPathToDeploymentManifest boş olmamalıdır.
Etkinleştirme URL'sini temizlemek çağıranın sorumluluğundadır. Örneğin, gerektiğinde kaçış karakterleri ekleme veya sorgu dizesini kaldırma.
Giriş uzunluğunu sınırlamak çağıranın sorumluluğundadır. Örneğin, en fazla URL uzunluğu 2 KB'tır.
LaunchApplication
Dağıtım URL'si kullanarak bir uygulamayı başlatır veya yükler.
Parametreler
| Parametre | Açıklama | Türü |
|---|---|---|
deploymentUrl |
Dağıtım bildiriminin URL'sini içeren NULL ile sonlandırılan dizeye yönelik bir işaretçi. | LPCWSTR |
data |
Daha sonraki kullanımlar için ayrılmıştır. NULL olmalıdır. | LPVOID |
flags |
Daha sonraki kullanımlar için ayrılmıştır. 0 olmalıdır. | DWORD |
Dönüş değeri
Başarılı olursa, S_OK döndürür; aksi takdirde, hatayı temsil eden bir HRESULT döndürür. Yönetilen bir özel durum oluşursa, 0x80020009 (DISP_E_EXCEPTION) döndürür.