MsiCloseHandle 関数 (msi.h)

MsiCloseHandle 関数は、開いているインストールハンドルを閉じます。

構文

UINT MsiCloseHandle(
  [in] MSIHANDLE hAny
);

[in] hAny

開いているインストールハンドルを指定します。

値	意味
ERROR_INVALID_HANDLE	無効なハンドルが関数に渡されました。
ERROR_SUCCESS	関数が正常に実行されました。

MsiCloseHandle は、ハンドルの作成を要求したのと同じスレッドから呼び出す必要があります。

次の関数は、 MsiCloseHandle を呼び出して使用後に閉じる必要があるハンドルを提供します。

MsiCreateRecord MsiGetActiveDatabase MsiGetLastErrorRecord MsiOpenPackage MsiOpenProduct MsiOpenDatabaseOpenView MsiViewFetch MsiViewGetColumnInfo MsiDatabaseGetPrimaryKeys MsiGetSummaryInformation MsiEnableUIPreview カスタムアクションを作成するときは、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