Funzione di callback SpInstanceInitFn (ntsecpkg.h)
La funzione SpInstanceInit viene chiamata una volta per ogni pacchetto di sicurezza contenuto in un SSP/AP, quando il provider di servizi condivisi/API viene caricato in un processo client/server. I pacchetti di sicurezza devono usare questa funzione per eseguire qualsiasi inizializzazione specifica della modalità utente.
Sintassi
SpInstanceInitFn Spinstanceinitfn;
NTSTATUS Spinstanceinitfn(
[in] ULONG Version,
[in] PSECPKG_DLL_FUNCTIONS FunctionTable,
[out] PVOID *UserFunctions
)
{...}
Parametri
[in] Version
Versione dell'Autorità di sicurezza locale (LSA).
[in] FunctionTable
Puntatore a una struttura SECPKG_DLL_FUNCTIONS contenente le funzioni di supporto che il pacchetto di sicurezza può usare in modalità utente.
[out] UserFunctions
Questo parametro non viene usato.
Valore restituito
Se la funzione ha esito positivo, restituire STATUS_SUCCESS.
Se la funzione ha esito negativo, restituire un codice NTSTATUS che indica il motivo per cui non è riuscito.
Commenti
La funzione SpInstanceInit viene chiamata una volta quando il provider di servizi condivisi/API viene caricato nel processo in modalità utente, dopo la chiamata della funzione SpUserModeInitialize .
SSP/APs deve implementare la funzione SpInstanceInit ; Tuttavia, il nome effettivo assegnato all'implementazione spetta allo sviluppatore.
Un puntatore alla funzione SpInstanceInit è 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 |