Share via

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

  • Artigo

A função SpGetCredentials recupera as credenciais primárias e complementares do objeto de usuário.

Sintaxe

SpGetCredentialsFn Spgetcredentialsfn;

NTSTATUS Spgetcredentialsfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [out] PSecBuffer Credentials
)
{...}

Parâmetros

[in] CredentialHandle

Um identificador para as credenciais a serem recuperadas.

[out] Credentials

Ponteiro para uma estrutura SecBuffer que recebe as credenciais.

Retornar valor

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

Se a função falhar, retorne um código NTSTATUS indicando o motivo pelo qual ela falhou. A seguir, lista os motivos comuns de falha e os códigos de erro que a função deve retornar.

Código de retorno Descrição
SEC_E_INSUFFICIENT_MEMORY
 Não há memória suficiente para recuperar as credenciais.
SEC_E_INVALID_HANDLE
 O identificador não é válido.

Comentários

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

Um ponteiro para a função SpGetCredentials 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