Funzione FindActCtxSectionStringA (winbase.h)

Articolo
11/20/2024

La funzione FindActCtxSectionString recupera informazioni su una stringa specifica nel contesto di attivazione corrente e restituisce una struttura ACTCTX_SECTION_KEYED_DATA.

Sintassi

BOOL FindActCtxSectionStringA(
  [in]  DWORD                      dwFlags,
  [in]  const GUID                 *lpExtensionGuid,
  [in]  ULONG                      ulSectionId,
  [in]  LPCSTR                     lpStringToFind,
  [out] PACTCTX_SECTION_KEYED_DATA ReturnedData
);

Parametri

[in] dwFlags

Flag che determinano il funzionamento di questa funzione. Attualmente è definito solo il flag seguente.

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

Riservato; deve essere null.

[in] ulSectionId

Identificatore della sezione stringa del contesto di attivazione in cui cercare la stringa specifica.

Di seguito sono riportati gli identificatori di sezione stringa validi:

ACTIVATION_CONTEXT_SECTION_ASSEMBLY_INFORMATION
ACTIVATION_CONTEXT_SECTION_DLL_REDIRECTION
ACTIVATION_CONTEXT_SECTION_WINDOW_CLASS_REDIRECTION
ACTIVATION_CONTEXT_SECTION_COM_PROGID_REDIRECTION

[in] lpStringToFind

Puntatore a una stringa con terminazione Null da usare come criteri di ricerca.

[out] ReturnedData

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

Valore restituito

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

Questa funzione imposta gli 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.

Osservazioni

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

Nota

L'intestazione winbase.h definisce FindActCtxSectionString come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winbase.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll

Vedere anche

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionGuid

Condividi tramite