Función LsaRetrievePrivateData (ntsecapi.h)

  • Artículo

No use las funciones de datos privados de LSA para el cifrado y el descifrado de datos genéricos. En su lugar, use las funciones CryptProtectData y CryptUnprotectData . Use solo las funciones de datos privados de LSA cuando sea necesario manipular secretos de LSA como se documenta en El modelo de datos de objetos secretos

Sintaxis

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

Parámetros

[in] PolicyHandle

Identificador de un objeto Policy . El identificador debe tener el derecho de acceso POLICY_GET_PRIVATE_INFORMATION. Para obtener más información, vea Apertura de un identificador de objeto de directiva.

[in] KeyName

Puntero a una estructura de LSA_UNICODE_STRING que contiene el nombre de la clave en la que se almacenan los datos privados.

Para crear un objeto especializado, agregue uno de los siguientes prefijos al nombre de clave.

Prefijo Significado
L$
 Para objetos locales.
G$
 Para objetos globales.
M$
 Para objetos de equipo.
 

Si no va a crear uno de estos tipos especializados, no es necesario especificar un prefijo de nombre de clave. Para obtener más información, vea Objeto de datos privados.

[out] PrivateData

Puntero a una variable que recibe un puntero a una estructura de LSA_UNICODE_STRING que contiene los datos privados.

Cuando ya no necesite la información, pase el puntero devuelto a LsaFreeMemory.

Valor devuelto

Si la función se realiza correctamente, la función devuelve STATUS_SUCCESS.

Si se produce un error en la función, devuelve un valor NTSTATUS , que puede ser el siguiente valor o uno de los valores devueltos de la función de directiva de LSA.

Código devuelto Descripción
STATUS_OBJECT_NAME_NOT_FOUND
 No se almacena ningún dato privado bajo el nombre especificado por el parámetro KeyName .
 

Puede usar la función LsaNtStatusToWinError para convertir el valor NTSTATUS en un código de error de Windows.

Comentarios

Debe ejecutar este proceso "Como administrador" o se produce un error en la llamada con ERROR_ACCESS_DENIED.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ntsecapi.h
Library Advapi32.lib
Archivo DLL Advapi32.dll

Consulte también

LSA_UNICODE_STRING

LsaFreeMemory

LsaStorePrivateData