NCryptRegisterProtectionDescriptorName-Funktion (ncryptprotect.h)

  • Artikel

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
ERROR_SUCCESS
 Die Funktion war erfolgreich.
NTE_INVALID_PARAMETER
 Der pwszName-Parameter darf nicht NULL sein, und der Wert, auf den der Parameter verweist, darf keine leere Zeichenfolge sein.
NTE_BAD_FLAGS
 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

Weitere Informationen

CNG DPAPI-Funktionen

NCryptQueryProtectionDescriptorName