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

  • Artigo

Lê uma credencial de domínio do Gerenciador de Credenciais.

Sintaxe

CredReadDomainCredentialsFn Credreaddomaincredentialsfn;

NTSTATUS Credreaddomaincredentialsfn(
  [in]  PLUID LogonId,
  [in]  ULONG CredFlags,
  [in]  PCREDENTIAL_TARGET_INFORMATIONW TargetInfo,
        ULONG Flags,
        PULONG Count,
  [out] PENCRYPTED_CREDENTIALW **Credential
)
{...}

Parâmetros

[in] LogonId

A ID de logon para a qual as credenciais serão lidas.

[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 não criptografado.
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] TargetInfo

Um ponteiro para uma estrutura CREDENTIAL_TARGET_INFORMATION que contém informações sobre o computador de destino.

Flags

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

Count

O número de elementos na matriz Credential .

[out] Credential

Um ponteiro para um ponteiro para uma matriz de estruturas ENCRYPTED_CREDENTIALW que recebem 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 CrediReadDomainCredentials 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