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

Usado para adicionar credenciais para uma entidade de segurança.

Sintaxe

SpAddCredentialsFn Spaddcredentialsfn;

NTSTATUS Spaddcredentialsfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [in]  PUNICODE_STRING PrincipalName,
  [in]  PUNICODE_STRING Package,
  [in]  ULONG CredentialUseFlags,
  [in]  PVOID AuthorizationData,
        PVOID GetKeyFunciton,
  [in]  PVOID GetKeyArgument,
  [out] PTimeStamp ExpirationTime
)
{...}

Parâmetros

[in] CredentialHandle

Um identificador para a credencial a ser adicionada.

[in] PrincipalName

Opcional. Ponteiro para uma estrutura UNICODE_STRING que contém o nome da entidade de segurança cujas credenciais estão sendo adicionadas.

[in] Package

Ponteiro para uma estrutura UNICODE_STRING que contém o nome do pacote de autenticação.

[in] CredentialUseFlags

Sinalizadores que indicam como as credenciais serão usadas. Os valores a seguir são válidos.

Valor	Significado
SECPKG_CRED_INBOUND	As credenciais serão usadas com a função AcceptSecurityContext (Geral ).
SECPKG_CRED_OUTBOUND	As credenciais serão usadas com a função InitializeSecurityContext (Geral ).

[in] AuthorizationData

Opcional. Ponteiro para dados de autenticação suplementar.

GetKeyFunciton

[in] GetKeyArgument

Ponteiro para o argumento usado com a função GetKeyFunction .

[out] ExpirationTime

Ponteiro para um TimeStamp que recebe a hora em que o identificador de credenciais expira.

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

SSP/APs devem implementar a função SpAddCredentials ; no entanto, o nome real fornecido para a implementação cabe ao desenvolvedor.

Um ponteiro para a função SpAddCredentials está disponível na estrutura SECPKG_FUNCTION_TABLE recebida da função SpLsaModeInitialize .

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_FUNCTION_TABLE

SpLsaModeInitialize