NCryptGetProtectionDescriptorInfo-Funktion (ncryptprotect.h)

  • Artikel

Die NCryptGetProtectionDescriptorInfo-Funktion ruft eine Schutzdeskriptorregelzeichenfolge ab.

Syntax

SECURITY_STATUS NCryptGetProtectionDescriptorInfo(
  [in]           NCRYPT_DESCRIPTOR_HANDLE hDescriptor,
  [in, optional] const NCRYPT_ALLOC_PARA  *pMemPara,
                 DWORD                    dwInfoType,
  [out]          void                     **ppvInfo
);

Parameter

[in] hDescriptor

Schutzdeskriptorhandle, das durch Aufrufen von NCryptCreateProtectionDescriptor erstellt wird.

[in, optional] pMemPara

Zeiger auf eine NCRYPT_ALLOC_PARA Struktur, die Sie verwenden können, um benutzerdefinierte Speicherverwaltungsfunktionen anzugeben. Wenn Sie dieses Argument auf NULL festlegen, wird intern die LocalAlloc-Funktion verwendet, um Arbeitsspeicher zuzuweisen, und Ihre Anwendung muss LocalFree aufrufen, um arbeitsspeicher freizugeben, auf den der ppvInfo-Parameter verweist.

dwInfoType

Gibt an, wie Deskriptorinformationen an den ppvInfo-Parameter zurückgegeben werden. Dies kann der folgende Wert sein:

Wert Bedeutung
NCRYPT_PROTECTION_INFO_TYPE_DESCRIPTOR_STRING
 Das ppvInfo-Argument gibt die Deskriptorregelzeichenfolge zurück.

[out] ppvInfo

Zeiger auf die Deskriptorinformationen.

Rückgabewert

Gibt einen status Code zurück, der den Erfolg oder Fehler der Funktion angibt. Mögliche Rückgabecodes sind u. a. die folgenden:

Rückgabecode Beschreibung
ERROR_SUCCESS
 Die Funktion war erfolgreich.
NTE_INVALID_PARAMETER
 Der ppvInfo-Parameter darf nicht NULL sein.
NTE_NOT_SUPPORTED
 Im dwInfoType-Parameter wurde ein nicht unterstützter Wert angegeben.
NTE_INVALID_HANDLE
 Das vom hDescriptor-Parameter angegebene Handle ist ungültig.

Anforderungen

   
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

NCryptCreateProtectionDescriptor