Funzione di callback spInitializeFn (ntsecpkg.h)

  • Articolo

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

Vedi anche

SECPKG_FUNCTION_TABLE

SECPKG_PARAMETERS

SpLsaModeInitialize