Funzione FindActCtxSectionGuid (winbase.h)

Articolo
03/09/2024

La funzione FindActCtxSectionGuid recupera informazioni su un GUID specifico nel contesto di attivazione corrente e restituisce una struttura ACTCTX_SECTION_KEYED_DATA .

Sintassi

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

Parametri

[in] dwFlags

Flag che determinano il funzionamento di questa funzione. Solo il flag seguente è attualmente definito.

Valore	Significato
FIND_ACTCTX_SECTION_KEY_RETURN_HACTCTX	Questa funzione restituisce l'handle del contesto di attivazione in cui sono stati trovati i dati di reindirizzamento nel membro hActCtx della struttura ACTCTX_SECTION_KEYED_DATA . Il chiamante deve usare ReleaseActCtx per rilasciare questo contesto di attivazione.

[in] lpExtensionGuid

Riservati; deve essere Null.

[in] ulSectionId

Identificatore della sezione del contesto di attivazione in cui cercare il GUID specificato.

Di seguito sono riportati gli identificatori di sezione GUID validi:

ACTIVATION_CONTEXT_SECTION_COM_SERVER_REDIRECTION
ACTIVATION_CONTEXT_SECTION_COM_INTERFACE_REDIRECTION
ACTIVATION_CONTEXT_SECTION_COM_TYPE_LIBRARY_REDIRECTION

Di seguito è riportato un identificatore di sezione GUID valido a partire da Windows Server 2003 e Windows XP con SP1:

ACTIVATION_CONTEXT_SECTION_CLR_SURROGATES

[in] lpGuidToFind

Puntatore a un GUID da usare come criteri di ricerca.

[out] ReturnedData

Puntatore a una struttura ACTCTX_SECTION_KEYED_DATA da compilare con le informazioni GUID richieste.

Valore restituito

Se la funzione ha esito positivo, restituisce TRUE. In caso contrario, restituisce FALSE.

Questa funzione imposta errori che possono essere recuperati chiamando GetLastError. Per un esempio, vedere Recupero del codice Last-Error. Per un elenco completo dei codici di errore, vedere Codici di errore di sistema.

Commenti

Questa funzione deve essere chiamata solo dai metodi API side-by-side o COM. Le applicazioni non devono chiamare direttamente questa funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionString

Share via