Funzione BCryptSetProperty (bcrypt.h)

Articolo
02/23/2024

La funzione BCryptSetProperty imposta il valore di una proprietà denominata per un oggetto CNG.

Sintassi

NTSTATUS BCryptSetProperty(
  [in, out] BCRYPT_HANDLE hObject,
  [in]      LPCWSTR       pszProperty,
  [in]      PUCHAR        pbInput,
  [in]      ULONG         cbInput,
  [in]      ULONG         dwFlags
);

Parametri

[in, out] hObject

Handle che rappresenta l'oggetto CNG per impostare il valore della proprietà.

[in] pszProperty

Puntatore a una stringa Unicode con terminazione null contenente il nome della proprietà da impostare. Può trattarsi di uno degli identificatori di proprietà primitive di crittografia predefiniti o di un identificatore di proprietà personalizzato.

[in] pbInput

Indirizzo di un buffer contenente il nuovo valore della proprietà. Il parametro cbInput contiene le dimensioni di questo buffer.

[in] cbInput

Dimensioni, in byte, del buffer pbInput .

[in] dwFlags

Set di flag che modificano il comportamento di questa funzione. Per questa funzione non sono definiti flag.

Valore restituito

Restituisce un codice di stato che indica l'esito positivo o negativo della funzione.

I codici restituiti possibili includono, ma non sono limitati a, i seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione ha avuto esito positivo.
STATUS_INVALID_HANDLE	L'handle nel parametro hObject non è valido.
STATUS_INVALID_PARAMETER	Uno o più parametri non sono validi.
STATUS_NOT_SUPPORTED	La proprietà denominata specificata dal parametro pszProperty non è supportata o è di sola lettura.

Commenti

A seconda delle modalità di processore supportate da un provider, È possibile chiamare BCryptSetProperty dalla modalità utente o dalla modalità kernel. I chiamanti in modalità kernel possono essere eseguiti in PASSIVE_LEVELIRQL o DISPATCH_LEVEL IRQL. Se il livello IRQL corrente è DISPATCH_LEVEL, i puntatori passati a BCryptSetProperty devono fare riferimento a memoria non di pagina (o bloccata). Se l'oggetto specificato nel parametro hObject è un handle, deve essere stato aperto usando il flag BCRYPT_PROV_DISPATCH .

Per chiamare questa funzione in modalità kernel, usare Cng.lib, che fa parte del Driver Development Kit (DDK). Windows Server 2008 e Windows Vista: Per chiamare questa funzione in modalità kernel, usare Ksecdd.lib.

Quando si imposta il valore per la proprietà BCRYPT_CHAINING_MODE, il parametro pbInput non è associato da cbInput. Il chiamante deve assicurarsi che venga fornita una stringa Unicode con terminazione null valida.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	bcrypt.h
Libreria	Bcrypt.lib
DLL	Bcrypt.dll

Share via