Função CredGetTargetInfoA (wincred.h)

  • Artigo

A função CredGetTargetInfo recupera todas as informações de nome de destino conhecidas para o computador de destino nomeado. Isso foi executado localmente e não precisa de nenhum privilégio específico. Espera-se que as informações retornadas sejam passadas para as funções CredReadDomainCredentials e CredWriteDomainCredentials . As informações não devem ser usadas para nenhuma outra finalidade.

Os pacotes de autenticação calculam TargetInfo ao tentar se autenticar em um TargetName. Os pacotes de autenticação armazenam em cache essas informações de destino para disponibilizá-la para CredGetTargetInfo. Portanto, as informações de destino só estarão disponíveis em uma tentativa recente de autenticar um TargetName.

Os pacotes de autenticação que não estão no processo LSA podem armazenar em cache um TargetInfo para recuperação posterior por CredGetTargetInfo chamando CredReadDomainCredentials com o sinalizador CRED_CACHE_TARGET_INFORMATION.

Sintaxe

BOOL CredGetTargetInfoA(
  [in]  LPCSTR                          TargetName,
  [in]  DWORD                           Flags,
  [out] PCREDENTIAL_TARGET_INFORMATIONA *TargetInfo
);

Parâmetros

[in] TargetName

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do computador de destino para o qual as informações devem ser recuperadas.

[in] Flags

Sinalizadores que controlam a operação da função. O seguinte sinalizador pode ser usado:

CRED_ALLOW_NAME_RESOLUTION

Se nenhuma informação de destino puder ser encontrada para a resolução de nome TargetName for feita em TargetName para convertê-la em outros formulários. Se houver informações de destino para qualquer uma dessas outras formas, elas serão retornadas. Atualmente, apenas a resolução de nomes DNS é feita.

Isso será útil se o aplicativo não chamar um pacote de autenticação diretamente. O aplicativo pode passar o TargetName para outra camada de software para autenticar no servidor, e essa camada de software pode resolve o nome e passar o nome resolvido para o pacote de autenticação. Dessa forma, não haverá informações de destino para o TargetName original.

[out] TargetInfo

Ponteiro para um único buffer de bloco alocado para conter as informações de destino. Pelo menos um dos membros retornados de TargetInfo será não NULL. Todos os ponteiros contidos no buffer são ponteiros para locais dentro desse único bloco alocado. O único buffer retornado deve ser liberado chamando CredFree.

Retornar valor

A função retorna TRUE em caso de êxito e FALSE em caso de falha. A função GetLastError pode ser chamada para obter um código de status mais específico. O seguinte código de status pode ser retornado:

  • ERROR_NOT_FOUND

    As informações de destino do servidor nomeado não estão disponíveis.

Comentários

Observação

O cabeçalho wincred.h define CredGetTargetInfo como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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 wincred.h
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

CredFree

CredReadDomainCredentials

CredWriteDomainCredentials

Obter Último Erro