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

Vedi anche

SECPKG_USER_FUNCTION_TABLE

SpUserModeInitialize