Funzione CredUnmarshalCredentialA (wincred.h)
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 |