Função CredGetSessionTypes (wincred.h)

  • Artigo

A função CredGetSessionTypes retorna a persistência máxima compatível com a sessão de logon atual. Uma persistência máxima separada é retornada para cada tipo de credencial.

Sintaxe

BOOL CredGetSessionTypes(
  [in]  DWORD   MaximumPersistCount,
  [out] LPDWORD MaximumPersist
);

Parâmetros

[in] MaximumPersistCount

Número de elementos na matriz MaximumPersist . Use CRED_TYPE_MAXIMUM para retornar todos os tipos de credencial definidos no momento.

[out] MaximumPersist

Ponteiro para uma matriz na qual retornar os valores de persistência. A matriz passada deve ter os elementos MaximumPersistCount longos. No retorno, cada elemento especifica a persistência máxima com suporte pelo tipo de credencial correspondente.

O chamador deve usar uma das seguintes definições para indexar na matriz:

  • CRED_TYPE_GENERIC
  • CRED_TYPE_DOMAIN_PASSWORD
  • CRED_TYPE_DOMAIN_CERTIFICATE
Ou seja, MaximumPersist[CRED_TYPE_GENERIC] especifica a persistência máxima com suporte para credenciais genéricas.

Os valores a seguir podem ser retornados em cada elemento da matriz.

Valor Significado
CRED_PERSIST_NONE
 Nenhuma credencial pode ser armazenada. Esse valor será retornado se o tipo de credencial não tiver suporte ou tiver sido desabilitado pela política.
CRED_PERSIST_SESSION
 Somente uma credencial específica da sessão pode ser armazenada.
CRED_PERSIST_LOCAL_MACHINE
 Credenciais específicas da sessão e específicas do computador podem ser armazenadas.

Windows XP: Essa credencial não pode ser armazenada para sessões nas quais o perfil não é carregado.
CRED_PERSIST_ENTERPRISE
 Qualquer credencial pode ser armazenada.

Windows XP: Essa credencial não pode ser armazenada para sessões nas quais o perfil não é carregado.

Retornar valor

Essa 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_NO_SUCH_LOGON_SESSION

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.

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