NCryptGetProtectionDescriptorInfo-Funktion (ncryptprotect.h)

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