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

  • Artigo

Atualizações as credenciais associadas ao contexto especificado.

Sintaxe

SpUpdateCredentialsFn Spupdatecredentialsfn;

NTSTATUS Spupdatecredentialsfn(
  [in] LSA_SEC_HANDLE ContextHandle,
  [in] GUID *CredType,
  [in] ULONG FlatCredUIContextLength,
       PUCHAR FlatCredUIContext
)
{...}

Parâmetros

[in] ContextHandle

Um identificador para o contexto a ser atualizado.

[in] CredType

O tipo de credencial especificado pelo parâmetro ContextHandle . Esse pode ser um dos valores a seguir.

Valor Significado
SEC_WINNT_AUTH_DATA_TYPE_PASSWORD
0x28bfc32f, 0x10f6, 0x4738, 0x98, 0xd1, 0x1a, 0xc0, 0x61, 0xdf, 0x71, 0x6a
 A credencial é uma senha.
SEC_WINNT_AUTH_DATA_TYPE_CERT
0x235f69ad, 0x73fb, 0x4dbc, 0x82, 0x3, 0x6, 0x29, 0xe7, 0x39, 0x33, 0x9b
 A credencial é um certificado.
SEC_WINNT_AUTH_DATA_TYPE_CSP_DATA
0x68fd9879, 0x79c, 0x4dfe, 0x82, 0x81, 0x57, 0x8a, 0xad, 0xc1, 0xc1, 0x0
 A credencial são dados de autenticação de um provedor de serviços criptográficos (CSP).

[in] FlatCredUIContextLength

O tamanho, em caracteres, do buffer especificado pelo parâmetro FlatCredUIContext .

FlatCredUIContext

Uma cadeia de caracteres que especifica as credenciais atualizadas.

Retornar valor

Se a função for bem-sucedida, retorne STATUS_SUCCESS ou um código de status informativo.

Se a função falhar, retorne um código de erro NTSTATUS que indica o motivo pelo qual ela falhou. Para obter mais informações, consulte Comentários.

Comentários

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

Requisitos

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