Funzione CredGetTargetInfoA (wincred.h)

  • Articolo

La funzione CredGetTargetInfo recupera tutte le informazioni sul nome di destinazione note per il computer di destinazione denominato. Questa operazione viene eseguita in locale e non richiede alcun privilegio specifico. Le informazioni restituite devono essere passate alle funzioni CredReadDomainCredentials e CredWriteDomainCredentials . Le informazioni non devono essere utilizzate per altri scopi.

I pacchetti di autenticazione calcolano TargetInfo quando si tenta di eseguire l'autenticazione in un TargetName. I pacchetti di autenticazione memorizzano nella cache queste informazioni di destinazione per renderle disponibili per CredGetTargetInfo. Pertanto, le informazioni di destinazione saranno disponibili solo da un tentativo recente di autenticare un TargetName.

I pacchetti di autenticazione non presenti nel processo LSA possono memorizzare nella cache un Oggetto TargetInfo per il recupero successivo da CredGetTargetInfo chiamando CredReadDomainCredentials con il flag CRED_CACHE_TARGET_INFORMATION.

Sintassi

BOOL CredGetTargetInfoA(
  [in]  LPCSTR                          TargetName,
  [in]  DWORD                           Flags,
  [out] PCREDENTIAL_TARGET_INFORMATIONA *TargetInfo
);

Parametri

[in] TargetName

Puntatore a una stringa con terminazione Null contenente il nome del computer di destinazione per cui recuperare le informazioni.

[in] Flags

Flag che controllano l'operazione della funzione. È possibile usare il flag seguente:

CRED_ALLOW_NAME_RESOLUTION

Se non è possibile trovare informazioni di destinazione per la risoluzione dei nomi TargetName su TargetName per convertirlo in altri moduli. Se esistono informazioni di destinazione per uno qualsiasi di questi altri moduli, viene restituito. Attualmente viene eseguita solo la risoluzione dei nomi DNS.

Ciò è utile se l'applicazione non chiama direttamente un pacchetto di autenticazione. L'applicazione può passare TargetName a un altro livello di software per l'autenticazione al server e tale livello di software potrebbe risolvere il nome e passare il nome risolto al pacchetto di autenticazione. Di conseguenza, non saranno presenti informazioni di destinazione per targetName originale.

[out] TargetInfo

Puntatore a un singolo buffer di blocchi allocato per contenere le informazioni di destinazione. Almeno uno dei membri restituiti di TargetInfo sarà diverso da NULL. Tutti i puntatori contenuti nel buffer sono puntatori a posizioni all'interno di questo singolo blocco allocato. Il singolo buffer restituito deve essere liberato chiamando CredFree.

Valore restituito

La funzione restituisce TRUE in caso di esito positivo e FALSE in caso di errore. È possibile chiamare la funzione GetLastError per ottenere un codice di stato più specifico. È possibile restituire il codice di stato seguente:

  • ERROR_NOT_FOUND

    Le informazioni di destinazione per il server denominato non sono disponibili.

Commenti

Nota

L'intestazione wincred.h definisce CredGetTargetInfo come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wincred.h
Libreria Advapi32.lib
DLL Advapi32.dll

Vedi anche

CredFree

CredReadDomainCredentials

CredWriteDomainCredentials

Getlasterror