Funzione CredMarshalCredentialA (wincred.h)

Articolo
03/03/2024

La funzione CredMarshalCredential trasforma una credenziale in una stringa di testo. Storicamente, molte funzioni, ad esempio NetUseAdd, accettano un nome di dominio, un nome utente e una password come credenziali. Queste funzioni non accettano certificati come credenziali. La funzione CredMarshalCredential converte tali credenziali in un modulo che può essere passato a queste API.

Le credenziali con marshalling devono essere passate come stringa nome utente a qualsiasi API attualmente passata. Il nome di dominio, se applicabile, passato a tale API deve essere passato come NULL o vuoto. Per le credenziali del certificato, il PIN del certificato deve essere passato all'API come password.

Il chiamante non deve modificare o stampare le credenziali con marshalling. Il valore restituito può essere convertito liberamente tra i set di caratteri Unicode, ANSI e OEM. La stringa è distinzione tra maiuscole e minuscole.

Sintassi

BOOL CredMarshalCredentialA(
  [in]  CRED_MARSHAL_TYPE CredType,
  [in]  PVOID             Credential,
  [out] LPSTR             *MarshaledCredential
);

Parametri

[in] CredType

Tipo delle credenziali da eseguire al marshalling.

[in] Credential

Credenziale per il marshalling.

Si tratta di uno dei valori CRED_MARSHAL_TYPE .

Se CredType è CertCredential, Credential punta a una struttura CERT_CREDENTIAL_INFO .

Se CredType è UsernameTargetCredential, le credenziali puntano a una struttura USERNAME_TARGET_CREDENTIAL_INFO .

[out] MarshaledCredential

Puntatore a una stringa con terminazione null contenente le credenziali con marshalling. 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

CredType non è valido.

Commenti

Nota

L'intestazione wincred.h definisce CredMarshalCredential 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