MsiCloseHandle 関数 (msi.h)
MsiCloseHandle 関数は、開いているインストール ハンドルを閉じます。
構文
UINT MsiCloseHandle(
[in] MSIHANDLE hAny
);
パラメーター
[in] hAny
開いているインストール ハンドルを指定します。
戻り値
| 値 | 意味 |
|---|---|
|
無効なハンドルが関数に渡されました。 |
|
関数が正常に実行されました。 |
注釈
MsiCloseHandle は、ハンドルの作成を要求したのと同じスレッドから呼び出す必要があります。
次の関数は、 MsiCloseHandle を呼び出して使用後に閉じる必要があるハンドルを提供します。
MsiCreateRecordMsiGetActiveDatabaseMsiGetLastErrorRecordMsiOpenPackage MsiOpenProductMsiOpenDatabaseOpenViewMsiViewFetchMsiViewGetColumnInfoMsiDatabaseGetPrimaryKeysMsiGetSummaryInformationMsiEnableUIPreview カスタム アクションを作成するときは、PMSIHANDLE 型の変数を使用することをお勧めします。インストーラーは PMSIHANDLE オブジェクトを閉じるので、PMSIHANDLE 型の変数を使用することをお勧めしますスコープ外に出る場合は、MsiCloseHandle を呼び出して MSIHANDLE オブジェクトを閉じる必要があります。
たとえば、次のようなコードを使っている場合:
MSIHANDLE hRec = MsiCreateRecord(3);
次のように変更します。
PMSIHANDLE hRec = MsiCreateRecord(3);
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Server 2012、Windows 8、Windows Server 2008 R2、または Windows 7 の Windows インストーラー 5.0。 Windows Server 2008 または Windows Vista の Windows インストーラー 4.0 または Windows インストーラー 4.5。 Windows Server 2003 または Windows XP の Windows インストーラー。 Windows インストーラーのバージョン別に必須となる最小 Windows サービス パックに関する詳細については、Windows インストーラーの実行時の要件に関する記事を参照してください。 |
| 対象プラットフォーム | Windows |
| ヘッダー | msi.h |
| Library | Msi.lib |
| [DLL] | Msi.dll |