Funzione CredUnmarshalCredentialA (wincred.h)

Articolo
03/13/2024

La funzione CredUnmarshalCredential trasforma una credenziale con marshalling nel formato originale.

Sintassi

BOOL CredUnmarshalCredentialA(
  [in]  LPCSTR             MarshaledCredential,
  [out] PCRED_MARSHAL_TYPE CredType,
  [out] PVOID              *Credential
);

Parametri

[in] MarshaledCredential

Puntatore a una stringa con terminazione null contenente le credenziali con marshalling.

[out] CredType

Tipo di credenziale specificato da MarshallaledCredential.

Si tratta di uno dei valori CRED_MARSHAL_TYPE .

[out] Credential

Puntatore alla credenziale non gestita. Se CredType restituisce CertCredential, il puntatore restituito corrisponde a una struttura CERT_CREDENTIAL_INFO . Se CredType restituisce UsernameTargetCredential, il puntatore restituito corrisponde a una struttura USERNAME_TARGET_CREDENTIAL_INFO .

Il chiamante deve liberare il buffer restituito usando CredFree.

Valore restituito

Questa funzione restituisce TRUE in caso di esito positivo e FALSE in caso di errore. La funzione GetLastError può essere chiamata per ottenere un codice di stato più specifico. Il codice di stato seguente può essere restituito:

ERROR_INVALID_PARAMETER

MarshallaledCredential non è valido.

Commenti

Nota

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

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