Funzione BCryptSetProperty (bcrypt.h)

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 cui 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à primitivi di crittografia predefiniti o 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. Non sono definiti flag per questa funzione.

Valore restituito

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

I codici restituiti possibili includono, ma non solo, quanto segue.

Osservazioni

A seconda delle modalità del processore supportate da un provider, è possibile chiamare BCryptSetProperty dalla modalità utente o dal kernel. I chiamanti in modalità kernel possono essere eseguiti in PASSIVE_LEVELirQL o DISPATCH_LEVEL IRQL. Se il livello IRQL corrente è DISPATCH_LEVEL, qualsiasi puntatore passato a BCryptSetProperty deve fare riferimento alla memoria non a 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.

Fabbisogno