Funzione di callback spQueryContextAttributesFn (ntsecpkg.h)

Articolo
03/05/2024

La funzione SpQueryContextAttributes recupera gli attributi di un contesto di sicurezza.

La funzione SpQueryContextAttributes è la funzione di invio per la funzione QueryContextAttributes (Generale)dell'interfaccia del provider di supporto della sicurezza.

Sintassi

SpQueryContextAttributesFn Spquerycontextattributesfn;

NTSTATUS Spquerycontextattributesfn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [in]  ULONG ContextAttribute,
  [out] PVOID Buffer
)
{...}

Parametri

[in] ContextHandle

Handle al contesto di sicurezza.

[in] ContextAttribute

Attributo di contesto da eseguire in query. Per un elenco di valori validi, vedere la funzione QueryContextAttributes (Generale).

[out] Buffer

Puntatore che riceve l'indirizzo di un buffer contenente gli attributi richiesti. La memoria per il parametro Buffer deve essere allocata con la funzione AllocateHeap dalla tabella delle funzioni SECPKG_DLL_FUNCTIONS in modalità utente. In modalità LSA ( Local Security Authority ) usare la funzione AllocateLsaHeap .

Valore restituito

Se la funzione ha esito positivo, restituire STATUS_SUCCESS.

Se la funzione ha esito negativo, restituisce un codice NTSTATUS che indica il motivo per cui non è riuscito. Di seguito viene elencato un motivo comune per l'errore e il codice di errore restituito dalla funzione.

Codice restituito	Descrizione
SEC_E_INVALID_HANDLE	L'handle non è valido.

Commenti

SSP/APs deve implementare la funzione SpQueryContextAttributes ; tuttavia, il nome effettivo assegnato all'implementazione è fino allo sviluppatore.

Un puntatore all'implementazione in modalità LSA della funzione SpQueryContextAttributes è disponibile nella struttura SECPKG_FUNCTION_TABLE ricevuta dalla funzione SpLsaModeInitialize .

Un puntatore all'implementazione in modalità utente della funzione SpQueryContextAttributes è disponibile nella struttura SECPKG_USER_FUNCTION_TABLE ricevuta dalla funzione SpUserModeInitialize .

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	ntsecpkg.h

Vedi anche

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize

Condividi tramite