Referenz zur nicht verwalteten API für ClickOnce
Nicht verwaltete öffentliche ClickOnce-APIs aus „dfshim.dll“.
CleanOnlineAppCache
Bereinigt oder deinstalliert alle Onlineanwendungen aus dem ClickOnce-Anwendungscache.
Rückgabewert
Bei erfolgreicher Ausführung wird S_OK zurückgegeben. Andernfalls ein wird HRESULT zurückgegeben, das den Fehler darstellt. Wenn eine verwaltete Ausnahme auftritt, wird 0x80020009 (DISP_E_EXCEPTION) zurückgegeben.
Bemerkungen
Wenn CleanOnlineAppCache aufgerufen wird, wird der ClickOnce-Dienst gestartet, wenn er noch nicht ausgeführt wird.
GetDeploymentDataFromManifest
Ruft Bereitstellungsinformationen aus dem Manifest und der Aktivierungs-URL ab.
Parameter
| Parameter | Beschreibung | type |
|---|---|---|
pcwzActivationUrl |
Ein Zeiger auf ActivationURL. |
LPCWSTR |
pcwzPathToDeploymentManifest |
Ein Zeiger auf PathToDeploymentManifest. |
LPCWSTR |
pwzApplicationIdentity |
Ein Zeiger auf einen Puffer zum Empfangen einer NULL-terminierten Zeichenfolge, die die vollständige zurückgegebene Anwendungsidentität angibt. | LPWSTR |
pdwIdentityBufferLength |
Ein Zeiger auf ein DWORD, das die Länge des pwzApplicationIdentity-Puffers in WCHARs angibt. Dies schließt den Leerraum für das NULL-Terminierungszeichen ein. |
LPDWORD |
pwzProcessorArchitecture |
Ein Zeiger auf einen Puffer zum Empfangen einer NULL-terminierten Zeichenfolge, die die Prozessorarchitektur der Anwendungsbereitstellung aus dem Manifest angibt. | LPWSTR |
pdwArchitectureBufferLength |
Ein Zeiger auf ein DWORD, das die Länge des pwzProcessorArchitecture-Puffers in WCHARs angibt. |
LPDWORD |
pwzApplicationManifestCodebase |
Ein Zeiger auf einen Puffer zum Empfangen einer NULL-terminierten Zeichenfolge, die die Codebasis des Assemblymanifests aus dem Manifest angibt. | LPWSTR |
pdwCodebaseBufferLength |
Ein Zeiger auf ein DWORD, das die Länge des pwzApplicationManifestCodebase-Puffers in WCHARs angibt. |
LPDWORD |
pwzDeploymentProvider |
Ein Zeiger auf einen Puffer zum Empfangen einer NULL-terminierten Zeichenfolge, die den Bereitstellungsanbieter aus dem Manifest angibt, sofern vorhanden. Andernfalls wird eine leere Zeichenfolge zurückgegeben. | LPWSTR |
pdwProviderBufferLength |
Ein Zeiger auf ein DWORD, das die Länge von pwzProviderBufferLength angibt. |
LPDWORD |
Rückgabewert
Bei erfolgreicher Ausführung wird S_OK zurückgegeben. Andernfalls ein wird HRESULT zurückgegeben, das den Fehler darstellt. Gibt HRESULTFROMWIN32(ERROR_INSUFFICIENT_BUFFER) zurück, wenn ein Puffer zu klein ist.
Bemerkungen
Zeiger dürfen nicht NULL sein. pcwzActivationUrl und pcwzPathToDeploymentManifest dürfen nicht leer sein.
Es liegt in der Verantwortung des Aufrufers, die Aktivierungs-URL zu bereinigen. Beispiel: Hinzufügen von Escapezeichen, wo sie benötigt werden, oder Entfernen der Abfragezeichenfolge.
Es liegt in der Verantwortung des Aufrufers, die Eingabelänge zu begrenzen. Die maximale URL-Länge beträgt beispielsweise 2 KB.
LaunchApplication
Startet oder installiert eine Anwendung mithilfe einer Bereitstellungs-URL.
Parameter
| Parameter | Beschreibung | type |
|---|---|---|
deploymentUrl |
Ein Zeiger auf eine NULL-terminierte Zeichenfolge, die die URL des Bereitstellungsmanifests enthält. | LPCWSTR |
data |
Für die zukünftige Verwendung reserviert. Muss NULL sein. | LPVOID |
flags |
Für die zukünftige Verwendung reserviert. Muss den Wert 0 (null) haben. | DWORD |
Rückgabewert
Bei erfolgreicher Ausführung wird S_OK zurückgegeben. Andernfalls ein wird HRESULT zurückgegeben, das den Fehler darstellt. Wenn eine verwaltete Ausnahme auftritt, wird 0x80020009 (DISP_E_EXCEPTION) zurückgegeben.