Compartilhar via


Função GetSecurityDescriptorRMControl (securitybaseapi.h)

A função GetSecurityDescriptorRMControl recupera os bits de controle do gerenciador de recursos .

Sintaxe

DWORD GetSecurityDescriptorRMControl(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [out] PUCHAR               RMControl
);

Parâmetros

[in] SecurityDescriptor

Um ponteiro para uma estrutura SECURITY_DESCRIPTOR que contém os bits de controle do gerenciador de recursos. O valor do membro Control é definido como SE_RM_CONTROL_VALID.

[out] RMControl

Um ponteiro para um buffer que recebe os bits de controle do gerenciador de recursos.

Retornar valor

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor a seguir será retornado.

Código de retorno Descrição
ERROR_INVALID_DATA
O sinalizador de bits SE_RM_CONTROL_VALID não está definido na estrutura de SECURITY_DESCRIPTOR especificada.

Comentários

Os bits de controle do gerenciador de recursos são de oito bits no membro Sbz1 da estrutura SECURITY_DESCRIPTOR que contém informações específicas para o gerenciador de recursos acessar a estrutura. Esses bits devem ser acessados somente por meio das funções GetSecurityDescriptorRMControl e SetSecurityDescriptorRMControl .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho securitybaseapi.h (inclua Windows.h)
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

Visão geral do Controle de Acesso

Funções de Controle de Acesso básicas

SECURITY_DESCRIPTOR

SetSecurityDescriptorRMControl