Funzione CredUnprotectW (wincred.h)

Articolo
11/20/2024

La funzione CredUnprotect decrittografa le credenziali precedentemente crittografate usando la funzione CredProtect . Le credenziali devono essere state crittografate nello stesso contesto di sicurezza in cui viene chiamato CredUnprotect.

Sintassi

BOOL CredUnprotectW(
  [in]      BOOL   fAsSelf,
  [in]      LPWSTR pszProtectedCredentials,
  [in]      DWORD  cchProtectedCredentials,
  [out]     LPWSTR pszCredentials,
  [in, out] DWORD  *pcchMaxChars
);

Parametri

[in] fAsSelf

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

[in] pszProtectedCredentials

Puntatore a una stringa che specifica le credenziali crittografate.

[in] cchProtectedCredentials

Dimensioni, in caratteri, del buffer pszProtectedCredentials.

[out] pszCredentials

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

[in, out] pcchMaxChars

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

Valore restituito

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

Per informazioni estese sull'errore, chiamare la funzione GetLastError . Nella tabella seguente vengono illustrati i valori comuni per la funzione GetLastError .

Codice/valore restituito	Descrizione
ERROR_NOT_CAPABLE	Il contesto di sicurezza usato per crittografare le credenziali è diverso dal contesto di sicurezza usato per decrittografare le credenziali.
ERROR_INSUFFICIENT_BUFFER	La pszCredentials buffer era di dimensioni insufficienti.

Osservazioni

Nota

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