Compartilhar via


Função SaferGetLevelInformation (winsafer.h)

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)