Condividi tramite


Funzione CredUnmarshalCredentialA (wincred.h)

La funzione CredUnmarshalCredential trasforma una credenziale di cui è stato eseguito il 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 che contiene le credenziali con marshalling.

[out] CredType

Tipo di credenziale specificato da MarshaledCredential.

Si tratta di uno dei valori CRED_MARSHAL_TYPE.

[out] Credential

Puntatore alla credenziale nonshaled. 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. È possibile chiamare la funzione GetLastError per ottenere un codice di stato più specifico. È possibile restituire il codice di stato seguente:

ERROR_INVALID_PARAMETER

MarshaledCredential non è valido.

Osservazioni

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

CERT_CREDENTIAL_INFO

CRED_MARSHAL_TYPE

CredFree

CredMarshalCredential

GetLastError

USERNAME_TARGET_CREDENTIAL_INFO