CredRead

9/8/2008

O CredRead função recupera informações credencial que são identificadas exclusivamente pela tupla que contém o tipo credencial e o destino identificação associado com a credencial. Essa função substitui CeCredRead.

Syntax

DWORD CredRead(
  WSTR   wszTarget,
  DWORD  dwTargetLen,
  DWORD  dwType,
  DWORD  dwFlags,
  PPCRED ppCred
);

Parameters

• wszTarget
  [no] Direcionar a pesquisa para. Deve ser terminada por caractere nulo e não pode ser NULL.

• dwTargetLen
  [no] Número de caracteres em seqüência de caracteres de destino, incluindo o NULL-terminador. Não pode exceder CRED_MAX_TARGET_LEN

• dwType
  [no] Tipo de credencial para pesquisa para. A seguinte tabela mostra os tipos credencial predefinidos.

  Tipo de credencial	Descrição
  CRED_TYPE_NTLM	Tipo de credencial usado para O NTLM.
  CRED_TYPE_KERBEROS	Credenciais tipo usado para Kerberos.
  CRED_TYPE_DOMAIN_PASSWORD	Credenciais tipo usado para autenticação domínio.
  CRED_TYPE_CERTIFICATE	Credenciais é um Certificado.
  CRED_TYPE_PLAINTEXT_PASSWORD	Credenciais é uma senha simples.
  CRED_TYPE_GENERIC	Credencial é armazenado como uma opacidade blob, mas não as características de identificação.

• dwFlags
  [no] Usado para controle credenciais usar como padrão, e pode ser uma do seguinte sinalizadores.

  Sinalizador	Descrição
  CRED_FLAG_NO_DEFAULT	Gerenciador de credencial não retornará credencial usar como padrão.
  CRED_FLAG_NO_IMPLICIT_DEFAULT	Gerenciador de credencial não retornará usar como padrão implícito.

• ppCred
  [out] Ponteiro para reserva um único bloco alocado para retornar a credencial. Qualquer ponteiros contidos neste reserva são apontadores para locais dentro o único bloco alocado.

  Para obter mais informações sobre a estrutura credencial usada, consulte a estrutura CRED.

Return Value

ERROR_SUCCESS é retornado ao sucesso. Para obter uma lista dos códigos de erro, consulte Credential Manager Error Codes.

Remarks

Pode haver múltiplo apresentam credenciais para o mesmo tipo. O comportamento usar como padrão das CredRead função é retornar uma credencial no seguinte ordem de preferência:

1. Coincide com uma credencial exato para o destino.
2. A credencial marcado padrão.
3. Uma credencial usar como padrão implícito.

Se nenhuma credencial correspondente for encontrado para a tupla especificada, e há um conjunto credencial usar como padrão para o tipo especificado na tupla, que credencial usar como padrão será retornado. Se não houver nenhuma credencial usar como padrão, em seguida, o usar como padrão implícito é retornado. dwFlags membro da credencial retornado pode ser usado para determinar a origem da credencial e o chamador pode levar apropriado ação. Se o chamador não é privilegiado, será o blob vazio para de confiança credenciais.

Em alguns casos você pode desejar receber somente uma correspondência exata para o destino. Depending on a maiúsculas e minúsculas, definido dwFlags Seja um CRED_FLAG_NO_DEFAULT Ou CRED_FLAG_NO_IMPLICIT_DEFAULT.

Ponteiros contidos a reserva único bloco alocado para retornar a credencial são apontadores para locais dentro o único bloco alocado. Esse única reserva retornada deve ser liberada pelo chamado CredFree e não pode ser NULL.

O dwFlags membro da credencial retornado pode ser usado para definir fora a origem da credencial. Se a pasta CRED_FLAG_DEFAULT é definido, significa não credencial correspondente foi encontrada, mas uma credencial usar como padrão foi encontrado. Se a pasta CRED_FLAG_IMPLICIT_DEFAULT é definida, e em seguida, isso significa que não houve nenhuma credencial usar como padrão ou credencial correspondente, e uma credencial usar como padrão implícito foi retornado.

Requirements

See Also

Reference

CRED
Credential Manager Functions