AssocGetPerceivedType 関数 (shlwapi.h)

[アーティクル]
03/05/2024

拡張子に基づいてファイルの認識型を取得します。

構文

LWSTDAPI AssocGetPerceivedType(
  [in]            PCWSTR        pszExt,
  [out]           PERCEIVED     *ptype,
  [out]           PERCEIVEDFLAG *pflag,
  [out, optional] PWSTR         *ppszType
);

パラメーター

[in] pszExt

種類: PCWSTR

ファイルの拡張子を含むバッファーへのポインター。これには、".txt" などの先頭の期間が含まれている必要があります。

[out] ptype

種類: PERCEIVED*

認識される型を示す、PERCEIVED 値へのポインター。

[out] pflag

種類: PERCEIVEDFLAG*

認識される型情報のソースを示す値へのポインター。次の値のうち 1 つ以上。

PERCEIVEDFLAG_UNDEFINED (0x0000)

認識された型が見つかりませんでした (PERCEIVED_TYPE_UNSPECIFIED)。

PERCEIVEDFLAG_SOFTCODED (0x0001)

認識される型は、レジストリ内の関連付けを通じて決定されました。

PERCEIVEDFLAG_HARDCODED (0x0002)

認識される型は、本質的に Windows に知られています。

PERCEIVEDFLAG_NATIVESUPPORT (0x0004)

認識される種類は、Windows で提供されるコーデックを使用して決定されました。

PERCEIVEDFLAG_GDIPLUS (0x0010)

認識される型は、GDI+ ライブラリでサポートされています。

PERCEIVEDFLAG_WMSDK (0x0020)

認識される種類は、Windows Media SDK でサポートされています。

PERCEIVEDFLAG_ZIPFOLDER (0x0040)

認識される種類は、Windows 圧縮フォルダーでサポートされています。

[out, optional] ppszType

種類: PWSTR*

関数が成功コードを返す場合、これには、認識された型文字列を受け取るバッファーへのポインターのアドレス (例: "text" または "video") が含まれます。この値には NULL を指定できます。

戻り値

型: HRESULT

この関数が成功すると、 S_OKが返されます。そうでない場合は、HRESULT エラーコードを返します。

注釈

この関数は、最初に拡張機能を Windows に知られているハードコーディングされた拡張機能のセットと比較します。その検索で一致するものが表示されない場合、HKEY_CLASSES_ROOTの下に登録されている関連付けによって、拡張機能に一致し、PerceivedType 値を含むキーが検索されます。その値が見つかった場合、拡張セットは再び一致を検索します。再び一致が見つからない場合、認識される型はPERCEIVED_TYPE_CUSTOMと判断されます。拡張機能と一致するキーまたは PerceivedType 値のいずれかが見つからない場合、認識される型はPERCEIVED_TYPE_UNSPECIFIEDとして報告されます。

要件

要件	値
サポートされている最小のクライアント	WINDOWS XP と SP2 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	shlwapi.h
Library	Shlwapi.lib
[DLL]	Shlwapi.dll (バージョン 6.0 以降)

次の方法で共有