Funzione LsaRetrievePrivateData (ntsecapi.h)

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.

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.

È 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

Vedi anche

LSA_UNICODE_STRING

LsaFreeMemory

LsaStorePrivateData