Função CredEnumerateA (wincred.h)
A função CredEnumerate enumera as credenciais do conjunto de credenciais do usuário. O conjunto de credenciais usado é o associado à sessão de logon do token atual. O token não deve ter o SID do usuário desabilitado.
Sintaxe
BOOL CredEnumerateA(
[in] LPCSTR Filter,
[in] DWORD Flags,
[out] DWORD *Count,
[out] PCREDENTIALA **Credential
);
Parâmetros
[in] Filter
Ponteiro para uma cadeia de caracteres terminada em nulo que contém o filtro para as credenciais retornadas. Somente as credenciais com um TargetName correspondente ao filtro serão retornadas. O filtro especifica um prefixo de nome seguido por um asterisco. Por exemplo, o filtro "FRED*" retornará todas as credenciais com um TargetName começando com a cadeia de caracteres "FRED".
Se NULL for especificado, todas as credenciais serão retornadas.
[in] Flags
O valor desse parâmetro pode ser zero ou mais dos valores a seguir combinados com uma operação OR bit a bit.
[out] Count
Contagem das credenciais retornadas na matriz Credenciais .
[out] Credential
Ponteiro para uma matriz de ponteiros para credenciais. A credencial retornada é um único bloco alocado. 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. Os seguintes códigos de status podem ser retornados.
Valor/código retornado | Descrição |
---|---|
|
Não existe nenhuma credencial que corresponda ao Filtro especificado. |
|
A sessão de logon não existe ou não há nenhum conjunto de credenciais associado a esta sessão de logon. As sessões de logon de rede não têm um conjunto de credenciais associado. |
|
Um sinalizador que não é válido foi especificado para o parâmetro Flags ou CRED_ENUMERATE_ALL_CREDENTIALS é especificado para o parâmetro Flags e o parâmetro Filter não é NULL. |
Comentários
Observação
O cabeçalho wincred.h define CredEnumerate 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 |