Funzione NCryptGetProtectionDescriptorInfo (ncryptprotect.h)

  • Articolo

La funzione NCryptGetProtectionDescriptorInfo recupera una stringa di regola del descrittore di protezione.

Sintassi

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

Parametri

[in] hDescriptor

Handle descrittore di protezione creato chiamando NCryptCreateProtectionDescriptor.

[in, optional] pMemPara

Puntatore a una struttura NCRYPT_ALLOC_PARA che è possibile usare per specificare funzioni di gestione della memoria personalizzate. Se si imposta questo argomento su NULL, la funzione LocalAlloc viene usata internamente per allocare memoria e l'applicazione deve chiamare LocalFree per rilasciare la memoria a cui fa riferimento il parametro ppvInfo .

dwInfoType

Specifica come restituire le informazioni del descrittore al parametro ppvInfo . Questo può essere il valore seguente:

Valore Significato
NCRYPT_PROTECTION_INFO_TYPE_DESCRIPTOR_STRING
 L'argomento ppvInfo restituisce la stringa di regola del descrittore.

[out] ppvInfo

Puntatore alle informazioni del descrittore.

Valore restituito

Restituisce un codice di stato che indica l'esito positivo o negativo della funzione. I codici restituiti possibili includono, ma non sono limitati a, i seguenti.

Codice restituito Descrizione
ERROR_SUCCESS
 La funzione ha avuto esito positivo.
NTE_INVALID_PARAMETER
 Il parametro ppvInfo non può essere NULL.
NTE_NOT_SUPPORTED
 Un valore non supportato è stato specificato nel parametro dwInfoType .
NTE_INVALID_HANDLE
 L'handle specificato dal parametro hDescriptor non è valido.

Requisiti

   
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ncryptprotect.h
Libreria NCrypt.lib
DLL NCrypt.dll

Vedi anche

Funzioni DPAPI CNG

NCryptCreateProtectionDescriptor