Funzione LsaRetrievePrivateData (ntsecapi.h)

  • Articolo

Non usare le funzioni dati private LSA per la crittografia dei dati generica e la decrittografia. Usare invece le funzioni CryptProtectData e CryptUnprotectData . Usare le funzioni dati private LSA solo quando è necessario modificare i segreti LSA come documentato in Secret Object Data Model

Sintassi

NTSTATUS LsaRetrievePrivateData(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PLSA_UNICODE_STRING KeyName,
  [out] PLSA_UNICODE_STRING *PrivateData
);

Parametri

[in] PolicyHandle

Handle per un oggetto Policy . L'handle deve avere il diritto di accesso POLICY_GET_PRIVATE_INFORMATION. Per altre informazioni, vedere Apertura di un handle oggetto Criteri.

[in] KeyName

Puntatore a una struttura LSA_UNICODE_STRING che contiene il nome della chiave in cui vengono archiviati i dati privati.

Per creare un oggetto specializzato, aggiungere uno dei prefissi seguenti al nome della chiave.

Prefisso Significato
L$
 Per gli oggetti locali.
G$
 Per gli oggetti globali.
M$
 Per gli oggetti computer.
 

Se non si crea uno di questi tipi specializzati, non è necessario specificare un prefisso del nome della chiave. Per altre informazioni, vedere Oggetto dati privato.

[out] PrivateData

Puntatore a una variabile che riceve un puntatore a una struttura LSA_UNICODE_STRING che contiene i dati privati.

Quando le informazioni non sono più necessarie, passare il puntatore restituito a LsaFreeMemory.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce STATUS_SUCCESS.

Se la funzione ha esito negativo, restituisce un valore NTSTATUS , che può essere il valore seguente o uno dei valori restituiti della funzione criteri LSA.

Codice restituito Descrizione
STATUS_OBJECT_NAME_NOT_FOUND
 Nessun dato privato viene archiviato con il nome specificato dal parametro KeyName .
 

È possibile usare la funzione LsaNtStatusToWinError per convertire il valore NTSTATUS in un codice di errore di Windows.

Commenti

È necessario eseguire questo processo "Come amministratore" o la chiamata ha esito negativo con ERROR_ACCESS_DENIED.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ntsecapi.h
Libreria Advapi32.lib
DLL Advapi32.dll

Vedi anche

LSA_UNICODE_STRING

LsaFreeMemory

LsaStorePrivateData