Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |