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

Функция 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
 Эта функция возвращает дескриптор контекста активации, в котором данные перенаправления были найдены в элементе 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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

См. также

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionGuid