Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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