Funzione NCryptGetProtectionDescriptorInfo (ncryptprotect.h)
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 |
|---|---|
|
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 |
|---|---|
|
La funzione ha avuto esito positivo. |
|
Il parametro ppvInfo non può essere NULL. |
|
Un valore non supportato è stato specificato nel parametro dwInfoType . |
|
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 |