Partilhar via

Funções Globais de Segurança

Observação

A Active Template Library (ATL) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Estas funções fornecem suporte para modificar objetos SID e ACL.

Importante

As funções listadas na tabela seguinte não podem ser usadas em aplicações que sejam executadas no Windows Runtime.

Nome Description
AtlGetDacl Chame esta função para recuperar a informação da lista de controlo de acesso discricionária (DACL) de um objeto especificado.
AtlSetDacl Chame esta função para definir a informação discricionária da lista de controlo de acesso (DACL) de um objeto especificado.
AtlGetGroupSid Chame esta função para recuperar o identificador de segurança de grupo (SID) de um objeto.
AtlSetGroupSid Chame esta função para definir o identificador de segurança de grupo (SID) de um objeto.
AtlGetOwnerSid Chame esta função para recuperar o identificador de segurança do proprietário (SID) de um objeto.
AtlSetOwnerSid Chame esta função para definir o identificador de segurança do proprietário (SID) de um objeto.
AtlGetSacl Chame esta função para recuperar a informação da lista de controlo de acesso do sistema (SACL) de um objeto especificado.
AtlSetSacl Chame esta função para definir a informação da lista de controlo de acesso do sistema (SACL) de um objeto especificado.
AtlGetSecurityDescriptor Chame esta função para recuperar o descritor de segurança de um dado objeto.

Requerimentos

Cabeçalho: atlsecurity.h

AtlGetDacl

Chame esta função para recuperar a informação da lista de controlo de acesso discricionária (DACL) de um objeto especificado.

Importante

Esta função não pode ser usada em aplicações que sejam executadas em tempo de execução do Windows.

inline bool AtlGetDacl(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    CDacl* pDacl) throw();

Parâmetros

hObjeto
Handle para o objeto para o qual recuperar a informação de segurança.

TipoDeObjeto
Especifica um valor da enumeração SE_OBJECT_TYPE que indica o tipo de objeto identificado pelo parâmetro hObject .

pDacl
Apontador para um objeto DACL que conterá a informação de segurança recuperada.

Valor de retorno

Retorna verdadeiro no sucesso, falso no fracasso.

Observações

Em builds de depuração, ocorrerá um erro de asserção se hObject ou pDacl forem inválidos.

AtlSetDacl

Chame esta função para definir a informação discricionária da lista de controlo de acesso (DACL) de um objeto especificado.

Importante

Esta função não pode ser usada em aplicações que sejam executadas em tempo de execução do Windows.

inline bool AtlSetDacl(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    const CDacl& rDacl,
    DWORD dwInheritanceFlowControl = 0) throw(...);

Parâmetros

hObjeto
Handle para o objeto para o qual definir a informação de segurança.

TipoDeObjeto
Especifica um valor da enumeração SE_OBJECT_TYPE que indica o tipo de objeto identificado pelo parâmetro hObject .

rDacl
O DACL contendo as novas informações de segurança.

dwInheritanceFlowControl
O controlo do fluxo de herança. Este valor pode ser 0 (o padrão), PROTECTED_DACL_SECURITY_INFORMATION ou UNPROTECTED_DACL_SECURITY_INFORMATION.

Valor de retorno

Retorna verdadeiro no sucesso, falso no fracasso.

Observações

Em compilações de depuração, ocorrerá um erro de asserção se hObject for inválido, ou se dwInheritanceFlowControl não for um dos três valores permitidos.

Requerimentos

Cabeçalho: atlsecurity.h

AtlGetGroupSid

Chame esta função para recuperar o identificador de segurança de grupo (SID) de um objeto.

Importante

Esta função não pode ser usada em aplicações que sejam executadas em tempo de execução do Windows.

inline bool AtlGetGroupSid(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    CSid* pSid) throw(...);

Parâmetros

hObjeto
Handle para o objeto de onde se deve obter a informação de segurança.

TipoDeObjeto
Especifica um valor da enumeração SE_OBJECT_TYPE que indica o tipo de objeto identificado pelo parâmetro hObject .

pSid
Apontar para um CSid objeto que conterá a nova informação de segurança.

Valor de retorno

Retorna verdadeiro no sucesso, falso no fracasso.

Requerimentos

Cabeçalho: atlsecurity.h

AtlSetGroupSid

Chame esta função para definir o identificador de segurança de grupo (SID) de um objeto.

Importante

Esta função não pode ser usada em aplicações que sejam executadas em tempo de execução do Windows.

inline bool AtlSetGroupSid(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    const CSid& rSid) throw(...);

Parâmetros

hObjeto
Handle para o objeto para o qual definir a informação de segurança.

TipoDeObjeto
Especifica um valor da enumeração SE_OBJECT_TYPE que indica o tipo de objeto identificado pelo parâmetro hObject .

rSid
O CSid objeto que contém a nova informação de segurança.

Valor de retorno

Retorna verdadeiro no sucesso, falso no fracasso.

Requerimentos

Cabeçalho: atlsecurity.h

AtlGetOwnerSid

Chame esta função para recuperar o identificador de segurança do proprietário (SID) de um objeto.

Importante

Esta função não pode ser usada em aplicações que sejam executadas em tempo de execução do Windows.

inline bool AtlGetOwnerSid(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    CSid* pSid) throw(...);

Parâmetros

hObjeto
Handle para o objeto de onde se deve obter a informação de segurança.

TipoDeObjeto
Especifica um valor da enumeração SE_OBJECT_TYPE que indica o tipo de objeto identificado pelo parâmetro hObject .

pSid
Apontar para um CSid objeto que conterá a nova informação de segurança.

Valor de retorno

Retorna verdadeiro no sucesso, falso no fracasso.

Requerimentos

Cabeçalho: atlsecurity.h

AtlSetOwnerSid

Chame esta função para definir o identificador de segurança do proprietário (SID) de um objeto.

Importante

Esta função não pode ser usada em aplicações que sejam executadas em tempo de execução do Windows.

inline bool AtlSetOwnerSid(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    const CSid& rSid) throw(...);

Parâmetros

hObjeto
Handle para o objeto para o qual definir a informação de segurança.

TipoDeObjeto
Especifica um valor da enumeração SE_OBJECT_TYPE que indica o tipo de objeto identificado pelo parâmetro hObject .

rSid
O CSid objeto que contém a nova informação de segurança.

Valor de retorno

Retorna verdadeiro no sucesso, falso no fracasso.

Requerimentos

Cabeçalho: atlsecurity.h

AtlGetSacl

Chame esta função para recuperar a informação da lista de controlo de acesso do sistema (SACL) de um objeto especificado.

Importante

Esta função não pode ser usada em aplicações que sejam executadas em tempo de execução do Windows.

inline bool AtlGetSacl(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    CSacl* pSacl,
    bool bRequestNeededPrivileges = true) throw(...);

Parâmetros

hObjeto
Handle para o objeto de onde se deve obter a informação de segurança.

TipoDeObjeto
Especifica um valor da enumeração SE_OBJECT_TYPE que indica o tipo de objeto identificado pelo parâmetro hObject .

pSacl
Apontador para um objeto SACL que conterá a informação de segurança recuperada.

bRequestNeededPrivileges
Se for verdade, a função tentará ativar o privilégio de SE_SECURITY_NAME e restaurá-lo após a conclusão.

Valor de retorno

Retorna verdadeiro no sucesso, falso no fracasso.

Observações

Se AtlGetSacl for chamado várias vezes em muitos objetos diferentes, será mais eficiente ativar o privilégio SE_SECURITY_NAME uma vez antes de chamar a função, com bRequestNeededPrivileges definido como false.

Requerimentos

Cabeçalho: atlsecurity.h

AtlSetSacl

Chame esta função para definir a informação da lista de controlo de acesso do sistema (SACL) de um objeto especificado.

Importante

Esta função não pode ser usada em aplicações que sejam executadas em tempo de execução do Windows.

inline bool AtlSetSacl(
    HANDLE hObject,
    SE_OBJECT_TYPE ObjectType,
    const CSacl& rSacl,
    DWORD dwInheritanceFlowControl = 0,
    bool bRequestNeededPrivileges = true) throw(...);

Parâmetros

hObjeto
Handle para o objeto para o qual definir a informação de segurança.

TipoDeObjeto
Especifica um valor da enumeração SE_OBJECT_TYPE que indica o tipo de objeto identificado pelo parâmetro hObject .

rSacl
O SACL contém a nova informação de segurança.

dwInheritanceFlowControl
O controlo do fluxo de herança. Este valor pode ser 0 (o padrão), PROTECTED_SACL_SECURITY_INFORMATION ou UNPROTECTED_SACL_SECURITY_INFORMATION.

bRequestNeededPrivileges
Se for verdade, a função tentará ativar o privilégio de SE_SECURITY_NAME e restaurá-lo após a conclusão.

Valor de retorno

Retorna verdadeiro no sucesso, falso no fracasso.

Observações

Em compilações de depuração, ocorrerá um erro de asserção se hObject for inválido, ou se dwInheritanceFlowControl não for um dos três valores permitidos.

Se AtlSetSacl for chamado várias vezes em muitos objetos diferentes, será mais eficiente ativar o privilégio SE_SECURITY_NAME uma vez antes de chamar a função, com bRequestNeededPrivileges definido como false.

Requerimentos

Cabeçalho: atlsecurity.h

AtlGetSecurityDescriptor

Chame esta função para recuperar o descritor de segurança de um dado objeto.

Importante

Esta função não pode ser usada em aplicações que sejam executadas em tempo de execução do Windows.

inline bool AtlGetSecurityDescriptor(
    LPCTSTR pszObjectName,
    SE_OBJECT_TYPE ObjectType,
    CSecurityDesc* pSecurityDescriptor,
    SECURITY_INFORMATION requestedInfo = OWNER_SECURITY_INFORMATION |
    GROUP_SECURITY_INFORMATION | DACL_SECURITY_INFORMATION |
    SACL_SECURITY_INFORMATION,
bool bRequestNeededPrivileges = true) throw(...);

Parâmetros

pszObjectName
Apontador para uma cadeia terminada por nulo que especifica o nome do objeto do qual se deve obter informação de segurança.

TipoDeObjeto
Especifica um valor da enumeração SE_OBJECT_TYPE que indica o tipo de objeto identificado pelo parâmetro pszObjectName .

pSecurityDescriptor
O objeto que recebe o descritor de segurança solicitado.

solicitadoInformação
Um conjunto de flags de SECURITY_INFORMATION bits que indicam o tipo de informação de segurança a recuperar. Este parâmetro pode ser uma combinação dos seguintes valores.

bRequestNeededPrivileges
Se for verdade, a função tentará ativar o privilégio de SE_SECURITY_NAME e restaurá-lo após a conclusão.

Valor de retorno

Retorna verdadeiro no sucesso, falso no fracasso.

Observações

Se AtlGetSecurityDescriptor for chamado várias vezes em muitos objetos diferentes, será mais eficiente ativar o privilégio SE_SECURITY_NAME uma vez antes de chamar a função, com bRequestNeededPrivileges definido como false.

Requerimentos

Cabeçalho: atlsecurity.h

Consulte também

Funções

  • Last updated on