Funzione BCryptSetContextFunctionProperty (bcrypt.h)

  • Articolo

La funzione BCryptSetContextFunctionProperty imposta il valore di una proprietà denominata per una funzione crittografica in un contesto CNG esistente.

Sintassi

NTSTATUS BCryptSetContextFunctionProperty(
  [in] ULONG   dwTable,
  [in] LPCWSTR pszContext,
  [in] ULONG   dwInterface,
  [in] LPCWSTR pszFunction,
  [in] LPCWSTR pszProperty,
  [in] ULONG   cbValue,
  [in] PUCHAR  pbValue
);

Parametri

[in] dwTable

Identifica la tabella di configurazione presente nel contesto. Questo può essere uno dei valori seguenti.

Valore Significato
CRYPT_LOCAL
 Il contesto esiste nella tabella di configurazione del computer locale.
CRYPT_DOMAIN
 Questo valore non è disponibile per l'uso.

[in] pszContext

Puntatore a una stringa Unicode con terminazione null contenente l'identificatore del contesto in cui impostare la proprietà della funzione.

[in] dwInterface

Identifica l'interfaccia crittografica in cui esiste la funzione. Questo può essere uno dei valori seguenti.

Valore Significato
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE
 La funzione esiste nell'elenco delle funzioni di crittografia asimmetrica.
BCRYPT_CIPHER_INTERFACE
 La funzione esiste nell'elenco di funzioni di crittografia.
BCRYPT_HASH_INTERFACE
 La funzione esiste nell'elenco di funzioni hash.
BCRYPT_RNG_INTERFACE
 La funzione esiste nell'elenco delle funzioni del generatore di numeri casuali.
BCRYPT_SECRET_AGREEMENT_INTERFACE
 La funzione esiste nell'elenco delle funzioni del contratto segreto.
BCRYPT_SIGNATURE_INTERFACE
 La funzione esiste nell'elenco di funzioni di firma.
NCRYPT_KEY_STORAGE_INTERFACE
 La funzione esiste nell'elenco delle funzioni di archiviazione delle chiavi.
NCRYPT_SCHANNEL_INTERFACE
 La funzione esiste nell'elenco di funzioni Schannel.

[in] pszFunction

Puntatore a una stringa Unicode con terminazione null contenente l'identificatore della funzione crittografica per impostare la proprietà per.

[in] pszProperty

Puntatore a una stringa Unicode con terminazione null contenente l'identificatore della proprietà da impostare.

[in] cbValue

Contiene le dimensioni, in byte, del buffer pbValue . Si tratta del numero esatto di byte che verranno archiviati. Se il valore della proprietà è una stringa, è necessario aggiungere le dimensioni di un carattere per archiviare anche il carattere Null terminante, se necessario.

[in] pbValue

Indirizzo di un buffer contenente il nuovo valore della proprietà.

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_ACCESS_DENIED
 Il chiamante non dispone dell'accesso in scrittura alle proprietà per la funzione.
STATUS_INVALID_PARAMETER
 Uno o più parametri non sono validi.
STATUS_NO_MEMORY
 Si è verificato un errore di allocazione della memoria.
STATUS_NOT_FOUND
 Impossibile trovare il contesto o la funzione specificati.

Commenti

BCryptSetContextFunctionProperty può essere chiamato solo in modalità utente.

Requisiti

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