NCryptRegisterProtectionDescriptorName-Funktion (ncryptprotect.h)
Die NCryptRegisterProtectionDescriptorName-Funktion registriert den Anzeigenamen und die zugehörige Regelzeichenfolge für einen Schutzdeskriptor.
Syntax
SECURITY_STATUS NCryptRegisterProtectionDescriptorName(
[in] LPCWSTR pwszName,
[in, optional] LPCWSTR pwszDescriptorString,
DWORD dwFlags
);
Parameter
[in] pwszName
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Anzeigenamen des zu registrierenden Deskriptors enthält.
[in, optional] pwszDescriptorString
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die eine Schutzdeskriptorregel enthält. Wenn dieser Parameter NULL ist oder die Zeichenfolge leer ist, wird der Registrierungswert gelöscht, der zuvor für den pwszName-Parameter erstellt wurde.
dwFlags
Eine Konstante, die die Registrierungsstruktur angibt, unter der der neue Eintrag registriert werden soll. Wenn dieser Wert null (0) ist, wird der Registrierungsstamm HKEY_CURRENT_USER. Wenn dieser Wert NCRYPT_MACHINE_KEY_FLAG ist, wird der Stamm HKEY_LOCAL_MACHINE.
Rückgabewert
Gibt einen status Code zurück, der den Erfolg oder Fehler der Funktion angibt. Mögliche Rückgabecodes umfassen folgendes, sind aber nicht darauf beschränkt.
| Rückgabecode | Beschreibung |
|---|---|
|
Die Funktion war erfolgreich. |
|
Der pwszName-Parameter darf nicht NULL sein, und der Wert, auf den der Parameter verweist, darf keine leere Zeichenfolge sein. |
|
Der dwFlags-Parameter muss null oder NCRYPT_MACHINE_KEY_FLAG sein. |
Hinweise
Der mit dieser Funktion erstellte Registrierungsschlüssel ist nicht volatil. Die Informationen werden in einer Datei gespeichert und beibehalten, wenn der Computer heruntergefahren wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ncryptprotect.h |
| Bibliothek | NCrypt.lib |
| DLL | NCrypt.dll |