ClickOnce アンマネージド API リファレンス

dfshim.dll の ClickOnce アンマネージド パブリック API。

CleanOnlineAppCache

すべてのオンライン アプリケーションを ClickOnce アプリケーション キャッシュからクリーンまたはアンインストールします。

戻り値

成功した場合は S_OK を返します。それ以外の場合は、エラーを表す HRESULT を返します。 マネージド例外が発生した場合は、0x80020009 (DISP_E_EXCEPTION) を返します。

解説

CleanOnlineAppCache を呼び出すと、ClickOnce サービスがまだ実行されていない場合は起動されます。

GetDeploymentDataFromManifest

マニフェストおよびライセンス認証 URL から配置情報を取得します。

パラメーター

パラメーター 内容 Type
pcwzActivationUrl ActivationURL へのポインター。 LPCWSTR
pcwzPathToDeploymentManifest PathToDeploymentManifest へのポインター。 LPCWSTR
pwzApplicationIdentity 返される完全なアプリケーション ID を指定する NULL 終端文字列を受け取るバッファーへのポインター。 LPWSTR
pdwIdentityBufferLength pwzApplicationIdentity バッファーの長さ (WCHAR 単位) である DWORD へのポインター。 これには、NULL 終端文字用の空白が含まれます。 LPDWORD
pwzProcessorArchitecture アプリケーション配置のプロセッサ アーキテクチャを指定する NULL 終端文字列をマニフェストから受け取るためのバッファーへのポインター。 LPWSTR
pdwArchitectureBufferLength pwzProcessorArchitecture バッファーの長さ (WCHAR 単位) である DWORD へのポインター。 LPDWORD
pwzApplicationManifestCodebase アプリケーション マニフェストのコードベースを指定する NULL 終端文字列をマニフェストから受け取るためのバッファーへのポインター。 LPWSTR
pdwCodebaseBufferLength pwzApplicationManifestCodebase バッファーの長さ (WCHAR 単位) である DWORD へのポインター。 LPDWORD
pwzDeploymentProvider 存在する場合、配置プロバイダーを指定する NULL 終端文字列をマニフェストから受け取るためのバッファーへのポインター。 それ以外の場合は、空の文字列が返されます。 LPWSTR
pdwProviderBufferLength pwzProviderBufferLength の長さである DWORD へのポインター。 LPDWORD

戻り値

成功した場合は S_OK を返します。それ以外の場合は、エラーを表す HRESULT を返します。 バッファーが小さすぎる場合は、HRESULTFROMWIN32(ERROR_INSUFFICIENT_BUFFER) を返します。

解説

ポインターで null 値を指定することはできません。 pcwzActivationUrl および pcwzPathToDeploymentManifest を空にすることはできません。

ライセンス認証 URL をクリーンアップするのは、呼び出し元が行います。 たとえば、必要に応じてエスケープ文字を追加したり、クエリ文字列を削除したりします。

入力の長さを制限するのは、呼び出し元が行います。 たとえば、URL の最大長は 2 KB です。

LaunchApplication

配置 URL を使用してアプリケーションを起動またはインストールします。

パラメーター

パラメーター 内容 Type
deploymentUrl 配置マニフェストの URL を格納している NULL 終端文字列へのポインター。 LPCWSTR
data 将来利用するために予約されています。 NULL にする必要があります LPVOID
flags 将来利用するために予約されています。 0 を指定する必要があります。 DWORD

戻り値

成功した場合は S_OK を返します。それ以外の場合は、エラーを表す HRESULT を返します。 マネージド例外が発生した場合は、0x80020009 (DISP_E_EXCEPTION) を返します。

関連項目