FindActCtxSectionGuid 関数 (winbase.h)

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

構文

BOOL FindActCtxSectionGuid(
  [in]  DWORD                      dwFlags,
  [in]  const GUID                 *lpExtensionGuid,
  [in]  ULONG                      ulSectionId,
  [in]  const GUID                 *lpGuidToFind,
  [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

指定した GUID を検索するアクティブ化コンテキストのセクションの識別子。

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

  • ACTIVATION_CONTEXT_SECTION_COM_SERVER_REDIRECTION
  • ACTIVATION_CONTEXT_SECTION_COM_INTERFACE_REDIRECTION
  • ACTIVATION_CONTEXT_SECTION_COM_TYPE_LIBRARY_REDIRECTION
Windows Server 2003 および WINDOWS XP SP1 以降の有効な GUID セクション識別子を次に示します。
  • ACTIVATION_CONTEXT_SECTION_CLR_SURROGATES

[in] lpGuidToFind

検索条件として使用する GUID へのポインター。

[out] ReturnedData

要求された GUID 情報で入力する ACTCTX_SECTION_KEYED_DATA 構造体へのポインター。

戻り値

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

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

注釈

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

要件

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

関連項目

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionString

  • 最終更新: