次の方法で共有

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

  • [アーティクル]

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

構文

ENUMRESNAMEPROCA Enumresnameproca;

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

パラメーター

[in, optional] hModule

型: HMODULE

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

lpType

型: LPCTSTR

名前が列挙されるリソースの種類。 または、ポインターではなく、このパラメーターを MAKEINTRESOURCE(ID)できます。ここで、ID は定義済みのリソースの種類を表す整数値です。 標準リソースの種類については、「リソースの種類の」を参照してください。 詳細については、以下の「解説」セクションを参照してください。

lpName

型: LPTSTR

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

[in] lParam

型: LONG_PTR

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

戻り値

型: BOOL

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

備考

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

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

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

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

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー libloaderapi.h (Windows.h を含む)

関連項目

概念

EnumResourceNames の

EnumResourceNamesEx を する

IS_INTRESOURCE

リファレンス

リソース