Funzione BCryptQueryContextFunctionConfiguration (bcrypt.h)

[BCryptQueryContextFunctionConfiguration è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.

La funzione BCryptQueryContextFunctionConfiguration ottiene le informazioni di configurazione della funzione crittografica per un contesto CNG esistente.

Sintassi

NTSTATUS BCryptQueryContextFunctionConfiguration(
  [in]      ULONG                          dwTable,
  [in]      LPCWSTR                        pszContext,
  [in]      ULONG                          dwInterface,
  [in]      LPCWSTR                        pszFunction,
  [in, out] ULONG                          *pcbBuffer,
  [in, out] PCRYPT_CONTEXT_FUNCTION_CONFIG *ppBuffer
);

Parametri

[in] dwTable

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

[in] pszContext

Puntatore a una stringa Unicode con terminazione null contenente l'identificatore del contesto per ottenere le informazioni di configurazione della funzione per.

[in] dwInterface

Identifica l'interfaccia crittografica per ottenere le informazioni di configurazione della funzione per. Questo può essere uno dei valori seguenti.

[in] pszFunction

Puntatore a una stringa Unicode con terminazione null contenente l'identificatore della funzione di crittografia per ottenere le informazioni di configurazione per.

[in, out] pcbBuffer

L'indirizzo di una variabile ULONG che, nella voce, contiene le dimensioni, in byte, del buffer a cui punta ppBuffer. Se questa dimensione non è sufficiente per contenere le informazioni sul contesto, questa funzione avrà esito negativo con STATUS_BUFFER_TOO_SMALL.

Dopo che questa funzione restituisce, questa variabile contiene il numero di byte copiati nel buffer ppBuffer .

[in, out] ppBuffer

Indirizzo di un puntatore a una struttura CRYPT_CONTEXT_FUNCTION_CONFIG che riceve le informazioni di configurazione della funzione recuperate da questa funzione. Il valore indicato dal parametro pcbBuffer contiene le dimensioni di questo buffer.

Se il valore puntato da questo parametro è NULL, questa funzione allocherà la memoria necessaria. Questa memoria deve essere liberata quando non è più necessaria passando questo puntatore alla funzione BCryptFreeBuffer .

Se questo parametro è NULL, questa funzione inserisce le dimensioni necessarie, in byte, nella variabile a cui punta il parametro pcbBuffer e restituisce STATUS_BUFFER_TOO_SMALL.

Per altre informazioni sull'utilizzo di questo parametro, vedere Osservazioni.

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.

Commenti

Ogni funzione crittografica ha solo un set di informazioni di configurazione, quindi anche se il parametro ppBuffer sembra essere un utilizzato come matrice, questa funzione considera questa come matrice con un solo elemento. Nell'esempio seguente viene illustrato come viene usato questo parametro.

// Get the function configuration information.
CRYPT_CONTEXT_FUNCTION_CONFIG FuncConfig;
ULONG uSize = sizeof(FuncConfig);
PCRYPT_CONTEXT_FUNCTION_CONFIG pFuncConfig = &FuncConfig;
status = BCryptQueryContextFunctionConfiguration(
    CRYPT_LOCAL, 
    pszContext, 
    NCRYPT_SCHANNEL_INTERFACE,
    pszFunction,
    &uSize, 
    &pFuncConfig);

BCryptQueryContextFunctionConfiguration può essere chiamato solo in modalità utente.

Requisiti

Vedi anche

CRYPT_CONTEXT_FUNCTION_CONFIG