Funzione di callback spUserModeInitializeFn (ntsecpkg.h)

Articolo
02/29/2024

La funzione SpUserModeInitialize viene chiamata quando viene caricata una DLL delprovider/ di supporto della sicurezza(SSP/AP) nello spazio di elaborazione di un'applicazione client/server. Questa funzione fornisce le tabelle SECPKG_USER_FUNCTION_TABLE per ogni pacchetto di sicurezza nella DLL SSP/AP.

Sintassi

SpUserModeInitializeFn Spusermodeinitializefn;

NTSTATUS Spusermodeinitializefn(
  [in]  ULONG LsaVersion,
  [out] PULONG PackageVersion,
  [out] PSECPKG_USER_FUNCTION_TABLE *ppTables,
  [out] PULONG pcTables
)
{...}

Parametri

[in] LsaVersion

Versione della DLL del provider di sicurezza (Secur32.dll o Security.dll).

[out] PackageVersion

Puntatore che restituisce la versione della DLL SSP/AP.

[out] ppTables

Puntatore che restituisce una matrice di strutture SECPKG_USER_FUNCTION_TABLE . Ogni struttura è una tabella di puntatori alle funzioni in modalità utente implementate da un pacchetto di sicurezza distribuito nella DLL SSP/AP.

[out] pcTables

Puntatore che restituisce il numero di elementi nella matrice a cui punta il parametro ppTables .

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.

Commenti

La funzione SpUserModeInitialize deve essere implementata da DLL SSP/AP che contengono pacchetti di sicurezza in modalità utente.

Il parametro ppTables deve contenere un SECPKG_USER_FUNCTION_TABLE per ogni pacchetto di sicurezza in modalità utente distribuito nella DLL. Per altre informazioni sulla distribuzione di pacchetti di sicurezza nelle DLL, vedere Inizializzazione modalità utente.

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_USER_FUNCTION_TABLE

Condividi tramite