Funzione CryptSetOIDFunctionValue (wincrypt.h)

  • Articolo

La funzione CryptSetOIDFunctionValue imposta un valore per il tipo di codifica, il nome della funzione, l'OID e il nome del valore specificati.

Sintassi

BOOL CryptSetOIDFunctionValue(
  [in] DWORD      dwEncodingType,
  [in] LPCSTR     pszFuncName,
  [in] LPCSTR     pszOID,
  [in] LPCWSTR    pwszValueName,
  [in] DWORD      dwValueType,
  [in] const BYTE *pbValueData,
  [in] DWORD      cbValueData
);

Parametri

[in] dwEncodingType

Specifica il tipo di codifica da associare. Attualmente vengono usati solo X509_ASN_ENCODING e PKCS_7_ASN_ENCODING; Tuttavia, è possibile aggiungere altri tipi di codifica in futuro. Per trovare le corrispondenze con entrambi i tipi di codifica correnti, usare:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING.

[in] pszFuncName

Nome della funzione per cui viene aggiornato il tipo di codifica, l'OID e il nome del valore.

[in] pszOID

Se la parola di ordine elevato dell'identificatore di oggetto (OID) è diversa da zero, pszOID è un puntatore a una stringa OID, ad esempio "2.5.29.1" o una stringa ASCII , ad esempio "file". Se la parola di ordine elevato dell'OID è zero, la parola con ordine basso specifica l'identificatore integer da utilizzare come identificatore dell'oggetto.

[in] pwszValueName

Puntatore a una stringa Unicode contenente il nome del valore da impostare. Se un valore con questo nome non è già presente, la funzione la crea.

[in] dwValueType

Specifica il tipo di informazioni da archiviare come dati del valore. Questo parametro può avere uno dei valori seguenti.

Valore Significato
REG_DWORD
 Numero a 32 bit.
REG_EXPAND_SZ
 Stringa Unicode con terminazione Null che contiene riferimenti non espansi alle variabili di ambiente, ad esempio "%PATH%").
REG_MULTI_SZ
 Matrice di stringhe Unicode con terminazione Null, terminate da due caratteri NULL .
REG_SZ
 Stringa Unicode con terminazione Null.

[in] pbValueData

Punta a un buffer contenente i dati da archiviare per il nome del valore specificato.

[in] cbValueData

Specifica le dimensioni, in byte, delle informazioni a cui punta il parametro pbValueData . Se i dati sono di tipo REG_SZ, REG_EXPAND_SZ o REG_MULTI_SZ, le dimensioni devono includere il carattere wide NULL di terminazione.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero (TRUE).

Se la funzione ha esito negativo, il valore restituito è zero (FALSE).

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wincrypt.h
Libreria Crypt32.lib
DLL Crypt32.dll

Vedi anche

Funzioni di supporto OID