Funzione di callback spInitializeFn (ntsecpkg.h)
La funzione SpInitialize viene chiamata una volta dall'Autorità di sicurezza locale (LSA) per fornire un pacchetto di sicurezza con informazioni di sicurezza generali e una tabella di invio delle funzioni di supporto. Il pacchetto di sicurezza deve salvare le informazioni ed eseguire l'elaborazione di inizializzazione interna, se necessario.
Sintassi
SpInitializeFn Spinitializefn;
NTSTATUS Spinitializefn(
[in] ULONG_PTR PackageId,
[in] PSECPKG_PARAMETERS Parameters,
[in] PLSA_SECPKG_FUNCTION_TABLE FunctionTable
)
{...}
Parametri
[in] PackageId
Identificatore univoco l'LSA assegna a ogni pacchetto di sicurezza. Il valore è valido fino al riavvio del sistema.
[in] Parameters
Puntatore a una struttura SECPKG_PARAMETERS contenente informazioni sullo stato del dominio primario e del computer.
[in] FunctionTable
Puntatore a una tabella di funzioni di supporto LSA che un pacchetto di sicurezza può chiamare.
Valore restituito
Se la funzione ha esito positivo, restituire STATUS_SUCCESS o un codice di stato informativo.
Se la funzione ha esito negativo, restituisce un codice di errore NTSTATUS che indica il motivo per cui non è riuscito. Per altre informazioni, vedere la sezione Osservazioni.
Commenti
Se SpInitialize restituisce un codice di errore NTSTATUS all'LSA, il pacchetto verrà scaricato e l'Autorità di sicurezza locale (LSA) non lo includerà nell'elenco dei pacchetti di sicurezza disponibili.
SSP/AP deve implementare la funzione SpInitialize ; tuttavia, il nome effettivo assegnato all'implementazione è fino allo sviluppatore.
Un puntatore all'implementazione di SSP/AP della funzione SpInitialize deve trovarsi nella struttura SECPKG_FUNCTION_TABLE passata all'LSA dalla funzione SpLsaModeInitialize .
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 |