Share via

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

  • [アーティクル]

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

構文

ENUMRESNAMEPROCW Enumresnameprocw;

BOOL Enumresnameprocw(
  [in, optional] HMODULE hModule,
                 LPCWSTR lpType,
                 LPWSTR 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 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー libloaderapi.h (Windows.h を含む)

関連項目

概念

EnumResourceNames

EnumResourceNamesEx

IS_INTRESOURCE

リファレンス

リソース