ENUMRESTYPEPROCA コールバック関数 (libloaderapi.h)

  • [アーティクル]

EnumResourceTypes 関数と EnumResourceTypesEx 関数で使用されるアプリケーション定義のコールバック関数。 リソースの種類を受け取ります。 ENUMRESTYPEPROC 型は、このコールバック関数へのポインターを定義します。 EnumResTypeProc は、アプリケーション定義関数名のプレースホルダーです。

構文

ENUMRESTYPEPROCA Enumrestypeproca;

BOOL Enumrestypeproca(
  [in, optional] HMODULE hModule,
                 LPSTR lpType,
  [in]           LONG_PTR lParam
)
{...}

パラメーター

[in, optional] hModule

種類: HMODULE

型を列挙するリソースが実行可能ファイルに含まれているモジュールへのハンドル。 このパラメーターが NULL の場合、関数は、現在のプロセスの作成に使用されるモジュール内のリソースの種類を列挙します。

lpType

種類: LPTSTR

型が列挙されるリソースの種類。

または、ポインターではなく、このパラメーターに MAKEINTRESOURCE(ID) を指定できます。ID は、指定されたリソースの種類の整数識別子です。 標準リソースの種類については、「 リソースの種類」を参照してください。 詳細については、以下の「解説」セクションを参照してください。

[in] lParam

種類: LONG_PTR

EnumResourceTypes または EnumResourceTypesEx 関数に渡されるアプリケーション定義パラメーター。 このパラメーターは、エラー チェックで使用できます。

戻り値

種類: BOOL

列挙を続行する 場合は TRUE 、列挙を停止する 場合は FALSE を 返します。

解説

IS_INTRESOURCE(lpszType) が TRUE の場合、lpszType は指定されたリソースの種類の整数識別子を指定します。 それ以外の場合は、null で終わる文字列へのポインターです。 文字列の最初の文字がシャープ記号 (#) の場合、残りの文字は、リソースの種類の整数識別子を指定する 10 進数を表します。 たとえば、文字列 "#258" は識別子 258 を表します。

アプリケーションでは、 EnumResourceTypes または EnumResourceTypesEx 関数にアドレスを渡して、この関数 を登録する 必要があります。

コールバック関数が FALSE を返す場合、 EnumResourceTypes または EnumResourceTypesEx は列挙を停止し 、FALSE を返します。 Windows XP 以前では、 GetLastError から取得した値は ERROR_SUCCESSされます。Windows Vista 以降では、最後のエラー値が ERROR_RESOURCE_ENUM_USER_STOPされます。

Note

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

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー libloaderapi.h (Windows.h を含む)

関連項目

概念

EnumResourceTypes

EnumResourceTypesEx

IS_INTRESOURCE

リファレンス

リソース