Funzione CredProtectA (wincred.h)

Articolo
11/20/2024

La funzione CredProtect crittografa le credenziali specificate in modo che solo il contesto di sicurezza corrente possa decrittografarle.

Sintassi

BOOL CredProtectA(
  [in]      BOOL                 fAsSelf,
  [in]      LPSTR                pszCredentials,
  [in]      DWORD                cchCredentials,
  [out]     LPSTR                pszProtectedCredentials,
  [in, out] DWORD                *pcchMaxChars,
  [out]     CRED_PROTECTION_TYPE *ProtectionType
);

Parametri

[in] fAsSelf

Impostare su TRUE per specificare che le credenziali vengono crittografate nel contesto di sicurezza del processo corrente. Impostare su FALSE per specificare che le credenziali vengono crittografate nel contesto di sicurezza del contesto di sicurezza del thread chiamante.

[in] pszCredentials

Puntatore a una stringa che specifica le credenziali da crittografare. La funzione crittografa il numero di caratteri forniti nel parametro cchCredentials.

[in] cchCredentials

Dimensione, in caratteri, del buffer pszCredentials.

[out] pszProtectedCredentials

Puntatore a una stringa che, nell'output, riceve le credenziali crittografate.

[in, out] pcchMaxChars

Dimensioni, in caratteri del buffer di pszProtectedCredentials. In caso di output, se il pszProtectedCredentials non è di dimensioni sufficienti per ricevere le credenziali crittografate, questo parametro specifica le dimensioni richieste, in caratteri, del buffer pszProtectedCredentials.

[out] ProtectionType

Puntatore a un tipo di enumerazione CRED_PROTECTION_TYPE che, nell'output, specifica il tipo di protezione fornito.

Valore restituito

TRUE se la funzione ha esito positivo; in caso contrario, FALSE.

Per informazioni estese sull'errore, chiamare la funzione GetLastError .

Osservazioni

Si noti che l'output della funzione CredProtect non è protetto dall'integrità, quindi se l'output viene modificato, la funzione CredUnprotect non viene aggiornata e potrebbe produrre risultati non corretti.

Nota

L'intestazione wincred.h definisce CredProtect 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 Vista [solo app desktop]
server minimo supportato	Windows Server 2008 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	wincred.h
libreria	Advapi32.lib
dll	Advapi32.dll

Condividi tramite