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

Функция 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
 Эта функция возвращает дескриптор контекста активации, в котором данные перенаправления были найдены в элементе hActCtxструктуры ACTCTX_SECTION_KEYED_DATA . Вызывающий объект должен использовать 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
Ниже приведен допустимый идентификатор раздела GUID, начиная с Windows Server 2003 и Windows XP с пакетом обновления 1 (SP1):
  • ACTIVATION_CONTEXT_SECTION_CLR_SURROGATES

[in] lpGuidToFind

Указатель на GUID, используемый в качестве условия поиска.

[out] ReturnedData

Указатель на ACTCTX_SECTION_KEYED_DATA структуру, заполняемую запрошенными данными GUID.

Возвращаемое значение

Если функция завершается успешно, она возвращает значение TRUE. В противном случае возвращается значение FALSE.

Эта функция задает ошибки, которые можно получить, вызвав Метод GetLastError. Пример см. в разделе Извлечение кода Last-Error. Полный список кодов ошибок см. в разделе Системные коды ошибок.

Комментарии

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

Требования

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

См. также

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionString