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
この関数の動作方法を決定するフラグ。 現在、次のフラグのみが定義されています。
| 価値 | 意味 |
|---|---|
|
この関数は、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
この関数は、GetLastError
備考
この関数は、サイド バイ サイド API 関数または COM メソッドによってのみ呼び出す必要があります。 アプリケーションでは、この関数を直接呼び出さないでください。
手記
winbase.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして FindActCtxSectionString を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | winbase.h (Windows.h を含む) |
| ライブラリ | Kernel32.lib |
| DLL | Kernel32.dll |
関連項目
FindActCtxSectionGuid の