Funzione NCryptRegisterProtectionDescriptorName (ncryptprotect.h)

  • Articolo

La funzione NCryptRegisterProtectionDescriptorName registra il nome visualizzato e la stringa di regola associata per un descrittore di protezione.

Sintassi

SECURITY_STATUS NCryptRegisterProtectionDescriptorName(
  [in]           LPCWSTR pwszName,
  [in, optional] LPCWSTR pwszDescriptorString,
                 DWORD   dwFlags
);

Parametri

[in] pwszName

Puntatore a una stringa Unicode con terminazione null contenente il nome visualizzato del descrittore da registrare.

[in, optional] pwszDescriptorString

Puntatore a una stringa Unicode con terminazione null contenente una regola di descrittore di protezione. Se questo parametro è NULL o la stringa è vuota, il valore del Registro di sistema creato in precedenza per il parametro pwszName verrà eliminato.

dwFlags

Costante che indica l'hive del Registro di sistema in cui registrare la nuova voce. Se questo valore è zero (0), la radice del Registro di sistema è HKEY_CURRENT_USER. Se questo valore è NCRYPT_MACHINE_KEY_FLAG, la radice è HKEY_LOCAL_MACHINE.

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
ERROR_SUCCESS
 La funzione ha avuto esito positivo.
NTE_INVALID_PARAMETER
 Il parametro pwszName non può essere NULL e il valore a cui punta il parametro non può essere una stringa vuota.
NTE_BAD_FLAGS
 Il parametro dwFlags deve essere zero o NCRYPT_MACHINE_KEY_FLAG.

Commenti

La chiave del Registro di sistema creata tramite questa funzione non è volatile. Le informazioni vengono archiviate in un file e mantenute quando il computer viene arrestato.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ncryptprotect.h
Libreria NCrypt.lib
DLL NCrypt.dll

Vedi anche

Funzioni DPAPI CNG

NCryptQueryProtectionDescriptorName