FindActCtxSectionStringA 関数 (winbase.h)

  • [アーティクル]

FindActCtxSectionString 関数は、現在のアクティブ化コンテキスト内の特定の文字列に関する情報を取得し、ACTCTX_SECTION_KEYED_DATA構造体を返します。

構文

BOOL FindActCtxSectionStringA(
  [in]  DWORD                      dwFlags,
  [in]  const GUID                 *lpExtensionGuid,
  [in]  ULONG                      ulSectionId,
  [in]  LPCSTR                     lpStringToFind,
  [out] PACTCTX_SECTION_KEYED_DATA ReturnedData
);

パラメーター

[in] dwFlags

この関数の動作方法を決定するフラグ。 現在、次のフラグのみが定義されています。

値 説明
FIND_ACTCTX_SECTION_KEY_RETURN_HACTCTX
 この関数は、ACTCTX_SECTION_KEYED_DATA構造体の hActCtx メンバーでリダイレクト データが見つかったアクティブ化コンテキスト ハンドルを返します。 呼び出し元は、このアクティブ化コンテキストを解放するために ReleaseActCtx を使用する必要があります。

[in] lpExtensionGuid

予約;は null である必要があります。

[in] ulSectionId

特定の文字列を検索するアクティブ化コンテキストの文字列セクションの識別子。

有効な文字列セクション識別子を次に示します。

  • ACTIVATION_CONTEXT_SECTION_ASSEMBLY_INFORMATION
  • ACTIVATION_CONTEXT_SECTION_DLL_REDIRECTION
  • ACTIVATION_CONTEXT_SECTION_WINDOW_CLASS_REDIRECTION
  • ACTIVATION_CONTEXT_SECTION_COM_PROGID_REDIRECTION

[in] lpStringToFind

検索条件として使用する null で終わる文字列へのポインター。

[out] ReturnedData

要求された文字列情報を入力する ACTCTX_SECTION_KEYED_DATA 構造体へのポインター。

戻り値

関数が成功すると、 TRUE が返されます。 それ以外の場合は、 FALSE を返します。

この関数は 、GetLastError を呼び出すことによって取得できるエラーを設定します。 例については、「 Last-Error コードの取得」を参照してください。 エラー コードの完全な一覧については、「 システム エラー コード」を参照してください。

解説

この関数は、Side-by-side API 関数または COM メソッドによってのみ呼び出す必要があります。 アプリケーションでは、この関数を直接呼び出さないでください。

注意

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

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー winbase.h (Windows.h を含む)
Library Kernel32.lib
[DLL] Kernel32.dll

関連項目

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionGuid