Função de retorno de chamada SpUserModeInitializeFn (ntsecpkg.h)

A função SpUserModeInitialize é chamada quando uma DLL de SSP/AP (pacote de autenticação de provedor/ de suporte de segurança) é carregada no espaço de processo de um aplicativo cliente/servidor. Essa função fornece as tabelas SECPKG_USER_FUNCTION_TABLE para cada pacote de segurança na DLL SSP/AP.

Sintaxe

SpUserModeInitializeFn Spusermodeinitializefn;

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

Parâmetros

[in] LsaVersion

A versão da DLL do provedor de segurança (Secur32.dll ou Security.dll).

[out] PackageVersion

Ponteiro que retorna a versão da DLL SSP/AP.

[out] ppTables

Ponteiro que retorna uma matriz de estruturas de SECPKG_USER_FUNCTION_TABLE . Cada estrutura é uma tabela de ponteiros para as funções de modo de usuário implementadas por um pacote de segurança implantado na DLL SSP/AP.

[out] pcTables

Ponteiro que retorna o número de elementos na matriz apontada pelo parâmetro ppTables .

Retornar valor

Se a função for bem-sucedida, retorne STATUS_SUCCESS.

Se a função falhar, retorne um código NTSTATUS que indica o motivo pelo qual ela falhou.

Comentários

A função SpUserModeInitialize deve ser implementada por DLLs SSP/AP que contêm pacotes de segurança no modo de usuário.

O parâmetro ppTables deve conter uma SECPKG_USER_FUNCTION_TABLE para cada pacote de segurança do modo de usuário implantado na DLL. Para obter mais informações sobre como implantar pacotes de segurança em DLLs, consulte Inicialização do modo de usuário.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ntsecpkg.h

Confira também

SECPKG_USER_FUNCTION_TABLE