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

  • Artigo

Lê uma credencial do Gerenciador de Credenciais.

Sintaxe

CredReadFn Credreadfn;

NTSTATUS Credreadfn(
  [in]  PLUID LogonId,
  [in]  ULONG CredFlags,
  [in]  LPWSTR TargetName,
  [in]  ULONG Type,
  [in]  ULONG Flags,
  [out] PENCRYPTED_CREDENTIALW *Credential
)
{...}

Parâmetros

[in] LogonId

A ID de logon para a qual ler as credenciais.

[in] CredFlags

Sinalizadores que determinam o comportamento dessa função. Os sinalizadores a seguir são definidos.

Valor Significado
CREDP_FLAGS_IN_PROCESS
0x01
 O chamador está em processo.
CREDP_FLAGS_USE_MIDL_HEAP
0x02
 O chamador deve usar a função midl_user_allocate para alocar o buffer de credenciais .
CREDP_FLAGS_DONT_CACHE_TI
0x04
 Não armazene em cache as informações de destino.
CREDP_FLAGS_CLEAR_PASSWORD
0x08
 Os dados de credencial são passados como texto claro.
CREDP_FLAGS_USER_ENCRYPTED_PASSWORD
0x10
 Os dados de credencial são criptografados usando a função RtlEncryptMemory .
CREDP_FLAGS_TRUSTED_CALLER
0x20
 O chamador é um processo confiável.

[in] TargetName

O nome do computador de destino.

[in] Type

Especifica o tipo da credencial a ser lida. Os valores possíveis para esse parâmetro são os mesmos que os valores possíveis do membro Type da estrutura CREDENTIAL .

[in] Flags

Reservado. Esse parâmetro deve ser definido como zero.

[out] Credential

Um ponteiro para um ponteiro para uma estrutura ENCRYPTED_CREDENTIALW que recebe as credenciais que essa função lê.

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.

Comentários

Um ponteiro para a função CrediRead está disponível na estrutura LSA_SECPKG_FUNCTION_TABLE recebida pela função SpInitialize .

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

SpInitialize