Funzione NCryptRegisterProtectionDescriptorName (ncryptprotect.h)
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 |
---|---|
|
La funzione ha avuto esito positivo. |
|
Il parametro pwszName non può essere NULL e il valore a cui punta il parametro non può essere una stringa vuota. |
|
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 |