MsiGetUserInfoA 関数 (msi.h)

  • [アーティクル]

MsiGetUserInfo 関数は、インストールされている製品の登録済みユーザー情報を返します。

構文

USERINFOSTATE MsiGetUserInfoA(
  [in]      LPCSTR  szProduct,
  [out]     LPSTR   lpUserNameBuf,
  [in, out] LPDWORD pcchUserNameBuf,
  [out]     LPSTR   lpOrgNameBuf,
  [in, out] LPDWORD pcchOrgNameBuf,
  [in]      LPSTR   lpSerialBuf,
  [in, out] LPDWORD pcchSerialBuf
);

パラメーター

[in] szProduct

照会する製品の製品コードを指定します。

[out] lpUserNameBuf

ユーザーの名前を受け取る変数へのポインター。

[in, out] pcchUserNameBuf

lpUserNameBuf パラメーターが指すバッファーのサイズを文字単位で指定する変数へのポインター。 このサイズには、終端の null 文字を含める必要があります。

[out] lpOrgNameBuf

organization名を受け取るバッファーへのポインター。

[in, out] pcchOrgNameBuf

lpOrgNameBuf パラメーターによって指されるバッファーのサイズを文字単位で指定する変数へのポインター。 入力時には、終端の null 文字のスペースを含む、バッファーのフル サイズです。 渡されたバッファーが小さすぎる場合、返されるカウントには終端の null 文字は含まれません。

[in] lpSerialBuf

製品 ID を受け取るバッファーへのポインター。

[in, out] pcchSerialBuf

lpSerialBuf パラメーターが指すバッファーのサイズを文字単位で指定する変数へのポインター。 入力時には、終端の null 文字のスペースを含む、バッファーのフル サイズです。 渡されたバッファーが小さすぎる場合、返されるカウントには終端の null 文字は含まれません。

戻り値

値 意味
USERINFOSTATE_ABSENT
 ユーザー情報の一部または全部が存在しません。
USERINFOSTATE_INVALIDARG
 関数パラメーターの 1 つが無効でした。
USERINFOSTATE_MOREDATA
 バッファーが小さすぎて、要求されたデータを保持できません。
USERINFOSTATE_PRESENT
 関数は正常に終了しました。
USERINFOSTATE_UNKNOWN
 製品コードでは既知の製品が識別されません。
 
 

注釈

MsiGetUserInfo 関数が返されると、pcchNameBuf パラメーターには、バッファーに格納されているクラス文字列の長さが含まれます。 返されるカウントには、終端の null 文字は含まれません。 バッファーの大きさが十分でない場合、 MsiGetUserInfo 関数は USERINFOSTATE_MOREDATAを返し、 MsiGetUserInfo には文字列のサイズ (文字単位) が含まれますが、null 文字はカウントされません。

ユーザー情報は、会社名がない場合でも存在すると見なされます。

注意

msi.h ヘッダーは、MSIGetUserInfo をエイリアスとして定義します。これは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント 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

こちらもご覧ください

システム状態関数