Функция FindActCtxSectionStringA (winbase.h)

Статья
11/20/2024

Функция 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	Эта функция возвращает дескриптор контекста активации, где данные перенаправления найдены в элементе hActCtx элемента структуры ACTCTX_SECTION_KEYED_DATA. Вызывающий объект должен использовать ReleaseActCtx для выпуска этого контекста активации.

Ценность

Значение

FIND_ACTCTX_SECTION_KEY_RETURN_HACTCTX

Эта функция возвращает дескриптор контекста активации, где данные перенаправления найдены в элементе hActCtx элемента структуры ACTCTX_SECTION_KEYED_DATA. Вызывающий объект должен использовать 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. Полный список кодов ошибок см. в системных кодов ошибок.

Замечания

Эта функция должна вызываться только параллельными функциями API или методами COM. Приложения не должны напрямую вызывать эту функцию.

Заметка

Заголовок winbase.h определяет FindActCtxSectionString как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	winbase.h (включая Windows.h)
библиотеки	Kernel32.lib
DLL	Kernel32.dll

См. также

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionGuid

Поделиться через