Função LsaRetrievePrivateData (ntsecapi.h)

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.

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.

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

Confira também

LSA_UNICODE_STRING

LsaFreeMemory

LsaStorePrivateData