Função CredGetTargetInfoA (wincred.h)

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 CredReadDomainCredentials e credWriteDomainCredentials funções. As informações não devem ser usadas para qualquer outra finalidade.

Os pacotes de autenticação calculam TargetInfo ao tentar se autenticar em umtargetname . Os pacotes de autenticação armazenam em cache essas informações de destino para disponibilizá-los 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 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 sinalizador a seguir pode ser usado:

CRED_ALLOW_NAME_RESOLUTION

Se nenhuma informação de destino puder ser encontrada para a resolução de nomes do TargetName será feita em TargetName para convertê-la em outros formulários. Se houver informações de destino para qualquer um desses outros formulários, elas serão retornadas. Atualmente, somente 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 resolver o nome e passar o nome resolvido para o pacote de autenticação. Dessa forma, não haverá informações de destino para oTargetName original.

[out] TargetInfo

Ponteiro para um único buffer de bloco alocado para conter as informações de destino. Pelo menos um dos membros retornados do TargetInfo não será 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.

Valor de retorno

A função retorna TRUE com ê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 código de status a seguir pode ser retornado:

• ERROR_NOT_FOUND

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

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wincred.h
biblioteca	Advapi32.lib
de DLL	Advapi32.dll

Consulte também

CredFree

credReadDomainCredentials

credWriteDomainCredentials

GetLastError