estrutura CREDENTIAL_TARGET_INFORMATIONA (wincred.h)

A estrutura CREDENTIAL_TARGET_INFORMATION contém o nome, o domínio e a árvore do computador de destino.

Sintaxe

typedef struct _CREDENTIAL_TARGET_INFORMATIONA {
  LPSTR   TargetName;
  LPSTR   NetbiosServerName;
  LPSTR   DnsServerName;
  LPSTR   NetbiosDomainName;
  LPSTR   DnsDomainName;
  LPSTR   DnsTreeName;
  LPSTR   PackageName;
  ULONG   Flags;
  DWORD   CredTypeCount;
  LPDWORD CredTypes;
} CREDENTIAL_TARGET_INFORMATIONA, *PCREDENTIAL_TARGET_INFORMATIONA;

Membros

TargetName

Nome do servidor de destino, conforme especificado pelo chamador que acessa o destino. Normalmente, é o nome NetBIOS ou DNS do servidor de destino.

NetbiosServerName

NetBIOS nome do servidor de destino. Se o nome não for conhecido, esse membro poderá ser NULL.

DnsServerName

Nome DNS do servidor de destino. Se o nome não for conhecido, esse membro poderá ser NULL.

NetbiosDomainName

Nome NetBIOS do domínio do servidor de destino. Se o nome não for conhecido, esse membro poderá ser NULL. Se o servidor de destino for membro de um grupo de trabalho, esse membro deverá ser NULL.

DnsDomainName

Nome DNS do domínio do servidor de destino. Se o nome não for conhecido, esse membro poderá ser NULL. Se o servidor de destino for membro de um grupo de trabalho, esse membro deverá ser NULL.

DnsTreeName

Nome DNS da árvore do servidor de destino. Se o nome da árvore não for conhecido, esse membro poderá ser NULL. Se o servidor de destino for membro de um grupo de trabalho, esse membro deverá ser NULL.

PackageName

Nome do pacote de autenticação que determinou os valores NetbiosServerName, DnsServerName, NetbiosDomainName, DnsDomainName e DnsTreeName como uma função de TargetName. Esse membro pode ser passado para AcquireCredentialsHandle como o nome do pacote.

Flags

Atributos do destino.

  • CRED_TI_SERVER_FORMAT_UNKNOWN

    (1) — Defina se o pacote de autenticação não puder determinar se o nome do servidor é um nome DNS ou um nome NetBIOS. Nesse caso, o membro NetbiosServerName é definido como NULL e o membro DnsServerName é definido como o nome do servidor de formato desconhecido.

  • CRED_TI_DOMAIN_FORMAT_UNKNOWN

    (2) — Defina se o pacote de autenticação não puder determinar se o nome de domínio é um nome DNS ou um nome NetBIOS. Nesse caso, o membro NetbiosDomainName é definido como NULL e o membro DnsDomainName é definido como o nome de domínio de formato desconhecido.

  • CRED_TI_ONLY_PASSWORD_REQUIRED

    (4) — Defina se o pacote de autenticação determinou que o servidor só precisa de uma senha para autenticar. O chamador pode usar esse sinalizador para solicitar apenas uma senha e não um nome de usuário.

    As credenciais armazenadas exigem um membro UserName. Um valor de <DnsServerName>\Guest ou <NetbiosServerName>\Guest deve ser usado para esses servidores.

CredTypeCount

Número de elementos na matriz CredTypes .

CredTypes

Matriz que especifica os tipos de credencial aceitáveis pelo pacote de autenticação usado pelo servidor de destino. Cada elemento é um dos CRED_TYPE_* define. A ordem dessa matriz especifica a ordem de preferência do pacote de autenticação. Tipos mais preferíveis são especificados anteriormente na lista.

Comentários

Observação

O cabeçalho wincred.h define CREDENTIAL_TARGET_INFORMATION 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]
Cabeçalho wincred.h