AssocGetPerceivedType 関数 (shlwapi.h)

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

構文

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として報告されます。

要件