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

Статья
08/27/2023

Функция 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. Полный список кодов ошибок см. в разделе Системные коды ошибок.

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

Требования


Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionGuid