Funzione CredGetTargetInfoA (wincred.h)

La funzione CredGetTargetInfo recupera tutte le informazioni sul nome di destinazione note per il computer di destinazione denominato. Questa operazione viene eseguita localmente e non richiede privilegi specifici. È previsto che le informazioni restituite vengano 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 TargetInfo per il recupero successivo 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 targetName risoluzione dei nomi viene eseguita in 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 il 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 disponibili informazioni di destinazione per il 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.

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wincred.h
libreria	Advapi32.lib
dll	Advapi32.dll

Vedere anche

CredFree

CredReadDomainCredentials

CredWriteDomainCredentials

GetLastError