Função SaferGetLevelInformation (winsafer.h)

Artigo
03/04/2024

A função SaferGetLevelInformation recupera informações sobre um nível de política.

Sintaxe

BOOL SaferGetLevelInformation(
  [in]            SAFER_LEVEL_HANDLE      LevelHandle,
  [in]            SAFER_OBJECT_INFO_CLASS dwInfoType,
  [out, optional] LPVOID                  lpQueryBuffer,
  [in]            DWORD                   dwInBufferSize,
  [out]           LPDWORD                 lpdwOutBufferSize
);

Parâmetros

[in] LevelHandle

O identificador do nível a ser consultado.

[in] dwInfoType

Um SAFER_OBJECT_INFO_CLASS valor de enumeração que especifica o tipo de informações de objeto que devem ser retornadas. O valor especificado determina o tamanho e o tipo do parâmetro lpQueryBuffer . A tabela a seguir mostra os valores possíveis.

Valor	Significado
SaferObjectLevelId 1	Consultas para a constante LEVELID. Tipo de retorno lpQueryBuffer: DWORD.
SaferObjectScopeId 2	Consultas para o escopo do usuário ou do computador. Tipo de retorno lpQueryBuffer: DWORD.
SaferObjectFriendlyName 3	Consultas para o nome de exibição. Tipo de retorno lpQueryBuffer: LPCWSTR.
SaferObjectDescription 4	Consultas para a descrição. Tipo de retorno lpQueryBuffer: LPCWSTR.

[out, optional] lpQueryBuffer

Um buffer para conter os resultados da consulta. Para obter o tipo das informações retornadas para cada valor possível do parâmetro dwInfoType , consulte o parâmetro dwInfoType .

[in] dwInBufferSize

O tamanho do parâmetro lpQueryBuffer em bytes.

[out] lpdwOutBufferSize

Um ponteiro para retornar o tamanho de saída do parâmetro lpQueryBuffer .

Retornar valor

TRUE se a função for bem-sucedida; caso contrário, FALSE. Para obter informações de erro estendidas, chame GetLastError.

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	winsafer.h
Biblioteca	Advapi32.lib
DLL	Advapi32.dll
Conjunto de APIs	ext-ms-win-advapi32-safer-l1-1-0 (introduzido no Windows 8)

Compartilhar via