Funzione NCryptQueryProtectionDescriptorName (ncryptprotect.h)

Articolo
02/29/2024

La funzione NCryptQueryProtectionDescriptorName recupera la stringa di regola del descrittore di protezione associata a un nome visualizzato descrittore registrato.

Sintassi

SECURITY_STATUS NCryptQueryProtectionDescriptorName(
  [in]      LPCWSTR pwszName,
  [out]     LPWSTR  pwszDescriptorString,
  [in, out] SIZE_T  *pcDescriptorString,
            DWORD   dwFlags
);

Parametri

[in] pwszName

Nome visualizzato registrato per il descrittore di protezione. Registrare un nome chiamando la funzione NCryptRegisterProtectionDescriptorName .

[out] pwszDescriptorString

Stringa Unicode con terminazione null contenente la regola del descrittore di protezione. Impostare questo valore su NULL e impostare le dimensioni della stringa descrittore a cui punta l'argomento pcDescriptorString su zero nella chiamata iniziale a questa funzione. Per altre informazioni, vedere la sezione Osservazioni.

[in, out] pcDescriptorString

Puntatore a una variabile contenente il numero di caratteri nella stringa recuperata nel parametro pwszDescriptorString . Impostare la variabile su zero nella chiamata iniziale a questa funzione. Per altre informazioni, vedere la sezione Osservazioni.

dwFlags

Flag che specifica quale hive del Registro di sistema eseguire una query per il nome registrato. Questo può essere zero da cercare nell'hive HKEY_CURRENT_USER oppure è possibile specificare NCRYPT_MACHINE_KEY_FLAG per eseguire query sull'hive HKEY_LOCAL_MACHINE.

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 pwszName non può essere NULL e il valore a cui punta il parametro non può essere una stringa vuota.
NTE_BAD_FLAGS	Il parametro dwFlags deve essere zero o NCRYPT_MACHINE_KEY_FLAG.

Commenti

Per recuperare una stringa di regola del descrittore di protezione, è necessario chiamare questa funzione due volte. La prima volta che si chiama, impostare l'argomento pwszDescriptorString su NULL e il valore a cui punta l'argomento pcDescriptorString su zero. La prima chiamata recupera il numero di caratteri nella stringa del descrittore. Usare questo numero per allocare memoria per la stringa e recuperare un puntatore al buffer allocato. Per recuperare la stringa, chiamare di nuovo la funzione usando il puntatore.

Requisiti

Requisito	Valore
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

NCryptRegisterProtectionDescriptorName

Condividi tramite