MsiGetSourcePathW 関数 (msiquery.h)

MsiGetSourcePath 関数は、ディレクトリ テーブル内のフォルダーの完全なソース パスを返します。

構文

UINT MsiGetSourcePathW(
  [in]      MSIHANDLE hInstall,
  [in]      LPCWSTR   szFolder,
  [out]     LPWSTR    szPathBuf,
  [in, out] LPDWORD   pcchPathBuf
);

パラメーター

[in] hInstall

DLL カスタム アクションに対して提供されるインストール、または MsiOpenPackage、MsiOpenPackageEx、または MsiOpenProduct を使用して取得されたインストールを処理します。

[in] szFolder

ディレクトリ テーブルのレコードを指定する null で終わる文字列。 ディレクトリがルート ディレクトリの場合は、DefaultDir 列の値を指定できます。 それ以外の場合は、ディレクトリ列の値である必要があります。

[out] szPathBuf

null で終わる完全なソース パスを受け取るバッファーへのポインター。 szPathBuf に null (値=0) を渡してバッファーのサイズを判断しないでください。 バッファーのサイズを取得するには、空の文字列 (""など) を渡します。 その後、関数は ERROR_MORE_DATAを返し、 pcchPathBuf には、終端の null 文字を含めず、TCHAR に必要なバッファー サイズが含まれます。 ERROR_SUCCESSが返された場合、 pcchPathBuf には、終端の null 文字を含まない、バッファーに書き込まれた TCHAR の数が含まれます。

[in, out] pcchPathBuf

変数 szPathBuf が指すバッファーのサイズを TCHAR で指定する変数へのポインター。 関数がERROR_SUCCESSを返すと、この変数には 、szPathBuf にコピーされたデータのサイズが含まれます。終端の null 文字は含まれません。 szPathBuf が十分な大きさでない場合、関数は ERROR_MORE_DATAを返し、pcchPathBuf が指す変数に、終端の null 文字を含まない必要なサイズを格納します。

戻り値

MsiGetSourcePath 関数は、次の値を返します。

注釈

この関数を呼び出す前に、インストーラーで最初に CostInitialize アクション、 FileCost アクション、および CostFinalize アクションを実行する必要があります。 詳細については、「 プログラムからのデータベース関数の呼び出し」を参照してください。

ERROR_MORE_DATAが返された場合、ポインターである パラメーターは、文字列を保持するために必要なバッファーのサイズを指定します。 ERROR_SUCCESSが返された場合、文字列バッファーに書き込まれた文字数が返されます。 そのため、バッファーを指定するパラメーターに空の文字列 (""など) を渡すことで、バッファーのサイズを取得できます。 Null (値=0) を渡してバッファーのサイズを判断しないでください。

関数が失敗した場合は、 MsiGetLastErrorRecord を使用して拡張エラー情報を取得できます。

要件

こちらもご覧ください

インストーラーの場所関数

Windows インストーラー関数の引数として Null を渡す