Compartilhar via

Função LsaRetrievePrivateData (ntsecapi.h)

  • Artigo

Não use as funções de dados privados LSA para criptografia e descriptografia de dados genéricos. Em vez disso, use as funções CryptProtectData e CryptUnprotectData . Use apenas as funções de dados privados LSA quando for necessário manipular segredos LSA, conforme documentado no Modelo de Dados de Objeto Secreto

Sintaxe

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

Parâmetros

[in] PolicyHandle

Um identificador para um objeto Policy . O identificador deve ter o direito de acesso POLICY_GET_PRIVATE_INFORMATION. Para obter mais informações, consulte Abrindo um identificador de objeto de política.

[in] KeyName

Ponteiro para uma estrutura LSA_UNICODE_STRING que contém o nome da chave na qual os dados privados são armazenados.

Para criar um objeto especializado, adicione um dos seguintes prefixos ao nome da chave.

Prefixo Significado
L$
 Para objetos locais.
G$
 Para objetos globais.
M$
 Para objetos de computador.
 

Se você não estiver criando um desses tipos especializados, não precisará especificar um prefixo de nome de chave. Para obter mais informações, consulte Private Data Object.

[out] PrivateData

Ponteiro para uma variável que recebe um ponteiro para uma estrutura LSA_UNICODE_STRING que contém os dados privados.

Quando você não precisar mais das informações, passe o ponteiro retornado para LsaFreeMemory.

Retornar valor

Se a função for bem-sucedida, a função retornará STATUS_SUCCESS.

Se a função falhar, ela retornará um valor NTSTATUS , que pode ser o valor a seguir ou um dos valores retornados da função de política LSA.

Código de retorno Descrição
STATUS_OBJECT_NAME_NOT_FOUND
 Nenhum dado privado é armazenado sob o nome especificado pelo parâmetro KeyName .
 

Você pode usar a função LsaNtStatusToWinError para converter o valor NTSTATUS em um código de erro do Windows.

Comentários

Você deve executar esse processo "Como Administrador" ou a chamada falhará com ERROR_ACCESS_DENIED.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ntsecapi.h
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

LSA_UNICODE_STRING

LsaFreeMemory

LsaStorePrivateData