Função FindActCtxSectionGuid (winbase.h)

  • Artigo

A função FindActCtxSectionGuid recupera informações sobre um GUID específico no contexto de ativação atual e retorna uma estrutura ACTCTX_SECTION_KEYED_DATA .

Sintaxe

BOOL FindActCtxSectionGuid(
  [in]  DWORD                      dwFlags,
  [in]  const GUID                 *lpExtensionGuid,
  [in]  ULONG                      ulSectionId,
  [in]  const GUID                 *lpGuidToFind,
  [out] PACTCTX_SECTION_KEYED_DATA ReturnedData
);

Parâmetros

[in] dwFlags

Sinalizadores que determinam como essa função deve operar. Somente o sinalizador a seguir está definido no momento.

Valor Significado
FIND_ACTCTX_SECTION_KEY_RETURN_HACTCTX
 Essa função retorna o identificador de contexto de ativação em que os dados de redirecionamento foram encontrados no membro hActCtx da estrutura ACTCTX_SECTION_KEYED_DATA . O chamador deve usar ReleaseActCtx para liberar esse contexto de ativação.

[in] lpExtensionGuid

Reservados; deve ser nulo.

[in] ulSectionId

Identificador da seção do contexto de ativação no qual pesquisar o GUID especificado.

Veja a seguir os identificadores de seção guid válidos:

  • ACTIVATION_CONTEXT_SECTION_COM_SERVER_REDIRECTION
  • ACTIVATION_CONTEXT_SECTION_COM_INTERFACE_REDIRECTION
  • ACTIVATION_CONTEXT_SECTION_COM_TYPE_LIBRARY_REDIRECTION
Veja a seguir um identificador de seção GUID válido começando com o Windows Server 2003 e o Windows XP com SP1:
  • ACTIVATION_CONTEXT_SECTION_CLR_SURROGATES

[in] lpGuidToFind

Ponteiro para um GUID a ser usado como critérios de pesquisa.

[out] ReturnedData

Ponteiro para uma estrutura ACTCTX_SECTION_KEYED_DATA a ser preenchida com as informações de GUID solicitadas.

Retornar valor

Se a função for bem-sucedida, ela retornará TRUE. Caso contrário, retornará FALSE.

Essa função define erros que podem ser recuperados chamando GetLastError. Para obter um exemplo, consulte Recuperando o código de Last-Error. Para obter uma lista completa de códigos de erro, consulte Códigos de erro do sistema.

Comentários

Essa função só deve ser chamada pelas funções de API lado a lado ou métodos COM. Os aplicativos não devem chamar essa função diretamente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbase.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionString